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This publication describes programming services for 
using the IBM 2260 Display Station with the System/360 
Operating System. Included are descriptions of macro 
instructions for input/output control and for Basic and 
Express Attention Handling, along with some general 
requirements for using the display station effectively. 


Although intended primarily for the programmer cod- 
ing in System/360 assembler language, portions of this 
publication are also of interest to installation manag- 
ers, system engineers, system programmers, and others 
seeking general information about programming the IBM 
2260 Display Station. 


PREFACE 


This publication provides the reader IBM System/360 Component Description; 
with instructions and guidance in writing IBM 2260 Display Station, IBM 2848 
applications programs for the IBM 2260 Display Control, Form A27-2700 
Display Station (local attachment) under IBM System/360 Operating System; Con- 
overall control of the IBM System/360 Oper- cepts and Facilities, Form C28-6535 
ating System. The macro instructions and IBM System/360 Operating System; Assem- 
control program routines, which constitute bler Language, Form C28-6514 
a graphics access method for the 2260, are IBM System/360 Operating System; Job 
described in detail. Coding examples with Control Language, Form C28-6539 
accompanying explanations are included to IBM System/360 Operating System; Linkage 
illustrate uses of the macro instructions Editor, Form C28-6538 
and other modules provided. IBM System/360 Operating System; System 

.Programmer's Guide, Form C28-6550 

To take full advantage of the operating IBM System/360 Operating System; Super- 
system and the programming services provid- visor and Data Management Services, 
ed specifically for the IBM 2260, the Form C28-6646 
reader should have completed a basic course IBM System/360 Operating System; Super- 
in System/360 assembler language coding, or visor and Data Management Macro 
possess equivalent knowledge, and be famil- Instructions, Form C28-6647 


liar with the content of the following 
publications: 


Sixth Edition (November 1967) 


This is a major revision of, and obsoletes, IBM 
System/360 Operating System; Graphic Programming Ser- 
- vices for IBM 2260 Display Station (Local Attachment) , 

Form C27-6912-4. This publication implements the Data 
Entry Feature by removing the feature from a deferred 
status. In addition, while significant changes in 
presentation have been made throughout the present 
edition, only minor clarifications have been made to 
the technical content. 


Specifications contained herein are subject to change 
from time to time. Any such change will be reported 
in subsequent revisions or in Technical Newsletters. 


This publication was prepared for production using an IBM computer to 
update the text and to control the page and line format. Page impres- 
sions for photo-offset printing were obtained from an IBM 1403 Printer 
using a special print chain. 


Copies of this and other IBM publications can be obtained through IBM 
Branch Offices. 


A form for reader's comments appears at the back of this publication. 
Address any additional comments concerning the contents of this publica- 
tion to: IBM Corporation, Programming Publications, Department 637, 
Neighborhood Road, Kingston, New York 12401 


© International Business Machines Corporation 1966 
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The programming support described in 
this publication may be used with one or 
more IBM 2260 Display Stations connected to 
IBM System/360. Each display station is 
associated with an IBM 2848 Display Con- 
trol, which is connected directly to the 
processing unit via either a multiplexor 
channel or a selector channel. 


In this configuration, which is referred 
to as the “IBM 2260 Local," the display 
station may be located anywhere within a 
2000-foot cable distance from the display 
control. 


Through use of the IBM 2701 Data Adapter 
Unit and appropriate common carrier facili- 
ties, display stations may be located any 
distance from the central processing unit. 
This configuration, which is referred to as 
the "IBM 2260 Remote," is supported under 
the Basic Telecommunications Access Method 
(BTAM) and the Queued Telecommunications 
Access Method (QTAM). 


CONFIGURATIONS AND FEATURES 


There are two models of the IBM 2260 
display station, Models 1 and 2. Each is a 
cathode-ray tube (CRT) display and is 
available with or without an alphameric, 
numeric, or data entry keyboard. The 
optional keyboard enables man-machine com- 
munication on a continuing basis at the 


GENERAL INFORMATION 


The IBM 2848 Display Control contains 
the interface control, a character genera- 
tor, and buffer storage for the display 
stations. This buffer storage retains the 
video data to maintain display regeneration 
on the CRT. The data formats and number of 
characters that may be displayed on the 
face of the CRT, as well as the number and 
model of display stations that may be 
attached to a single display control, 
depend upon which of the five models of the 
display control is used, as shown in Table 


Models 21 and 22 of the IBM 2848 provide 
special capabilities for aiding data entry 
applications. These include extra keyboard 
character buffering and input/output com- 
mands which cause the keyboard of the 
addressed display station to remain mechan- 
ically locked to gain the attention of the 
operator. Models 21 and 22 may be used 
only in combination with an IBM 2260 Model 
Ze 


In addition, one IBM 1053 Printer Adapt- 
er Unit may be attached to each display 
control. This feature allows use of an IBM 
1053 Printer at a central location to 
document and record periodic system trans- 
actions. Like the display stations, the 
1053 Printer may be located up to 2000 feet 
from the display control. 


The programming services described in 
this publication support all of the option- 
al features of both the IBM 2260 and the 


display station. Other special features IBM 2848 described in detail in the compo- 
available with the IBM 2260 Local are Line nent description publication, Form A27- 
Addressing and Nondestructive Cursor. 2700. 

Table 1. Display Control Characteristics 

Fy ee ace ee ee ee ee ee a ee ee ee es 1 
| IBM 2848 Display Control | 
ae a RS ATO irt RECESS EEN EST See pe OR ee ee re ee ee A ee 
| Characteristic | Model 1 | Model 2 | Model 3 | Model 21 | Model 22 (| 
[-——--———----——--—--——+ jo—-- =~ fo—aa $--—--~----—- {-———----—--—- 4------------ : 
| Model No. of Display | 2 | 2 | 1 | 2 | 2 | 
| Stations to Be Used | | | | | | 
|--—------—---—_---——- {——-——------ {------------ {--—-------—- f—-—————— = | { 
| Max. No. of Display | 24 | 16 | 8 | 24 | 16 | 
| Stations i | | | | | 
po {—--—---—-- {------------ }------------ $------------ ——-—----—-- { 
| No. of Lines of | 6 | 12 | 12 | 6 | a2 | 
| Characters | | | | | | 
rn fn fo-a---- fmvnnnnn nnn frmn—e n= = { 
| No. of Characters | 40 | 40 | 80 | 40 | 40 | 
| Per Line | | | | | 
anna a ff nnn np nf nnn nad 
| Total No. of Charac- | 240 | 480 | 960 | 240 | 480 | 
| ters | | | | | | 
beget SS a ee boos esS oe on eS ere fe nn Py ae UE a a ea b Lesinper eevee ceed a J 


General Information 5 


PROGRAMMING SUPPORT 


Operating system programming support for 
the IBM 2260 Display Station includes macro 
instructions and control routines. They 
are used for two key functions: input/ 
output control and attention handling. The 
macro instructions function as part of the 
problem program; the control routines func- 
tion as part of the control program. This 
programming support constitutes a graphics 
access method for the 2260. 


The following paragraphs contain brief 
descriptions of the graphic programming 
services that are explained in detail in 


later sections. Appendixes include a_ sam- 
ple program and CCW formats. 
INPUT/OUTPUT CONTROL 

Input/output control macro instruc- 
tions are used for data transmission and 
control functions, for creating data con- 


trol blocks (DCBs), and for establishing 
and terminating system communication 
between problem programs and display sta- 


tions. Input/output control routines cre- 
ate channel command words (cCWs), issue 
supervisor calls to execute channel pro- 
grams, and control data transmission 


between main storage and display station 
buffer storage. 


ATTENTION HANDLING 

Attentions are Cunsched- 
uled) input/output interruptions of the 
CPU. They are caused by entries at a 
keyboard attached to a 2260 Display Sta- 
tion. 


asynchronous 


Basic Attention Handling 


Basic attention handling facilities 
automatically detect the occurrence of 
attentions, and route them to appropriate 
user-written attention handling routines. 
They also provide for queuing attentions 
and for overlapping wait intervals for 
expected attentions with selective proces- 
Sing. Macro instructions define the user's 
attention handling routines to the control 
program. 


Express Attention Handling 


Express attention handling facilities 
check for attentions as requested by the 
problem program. Attention information is 
then routed to appropriate user-written 
attention routines. Express attention han- 
dling information is contained in Appendix 
Cc. 


ERROR HANDLING 


Synchronous errors (i.e., input/output 
errors that occur during channel oper- 
ations) are handled by the IBM 2260 Stand- 
ard Error routine. This module analyzes 
the status and sense bytes for synchronous 
error conditions and provides appropriate 
error-recovery procedures for specific 
error situations. 


The IBM 2260 Standard Error routine 
provides a message to the operator whenever 
operator intervention is required, or 
whenever a Bus Out Check or Equipment Check 
occurs. These messages appear in the pub- 


lication IBM System/360 Operating System; 


Messages, Completion Codes, and Storage 
Dumps, Form C28-6631. 


SYSTEM GENERATION 


The IBM 2260 user defines his graphic 
configuration to the operating system he is 
generating through use of appropriate 
SYSGEN macro instructions. System genera- 
tion requirements are described in the 
publication IBM System/360 Operating Sys- 
tem; System Generation, Form C28-6554. 


MULTIPROGRAMMING WITH A VARIABLE NUMBER OF 
TASKS (MVT) 


Capability for multiprogramming with a 
variable number of tasks is provided by the 
graphic programming services described in 
this publication. Where special considera- 
tions apply to the use of these services in 
an MVT environment, these considerations 
will be noted at the end of the section to 
which they apply. 


FORMAT ILLUSTRATION CONVENTIONS 


Each macro instruction discussed in this 
publication is illustrated by the following 
coding format: 


eM ee ee et he ee ag te ete oo A eo eed 


|Name |Operation |Operand |Comments | 


}------}----------}--------------}--------4 


|Symbol|Macro name|None, or one | . | 


| or | jor more oper-: | | 
[blank | jands separated | | 
| | | by commas | | 
 Seaiiecemnen cera MS ae BU Ae etek ee eR ae eee EO Pes oad 


The coding format illustrations use the 
following conventions: 


e Upper case (capital) letters, numbers, 
and punctuation marks must be coded by 
the programmer exactly as shown. 
Exceptions to this convention are 
brackets, [ ], braces, { }, and ellip- 


ses, e-. . These three exceptions are 


never coded. 


e Lower case (small) letters and words 
represent variables for which specific 
information or specific values must be 
substituted by the programmer when cod- 
ing. 


e Items or groups of items within brack- 
ets, [1], are optional. They may he 
omitted at the programmer's discretion. 


e Braces, { }, indicate that one operand 
from the group must be chosen unless a 
default option is indicated. 

default 


e Underscoring indicates a 


option; that is, if no operand is 
coded, the underscored operand is 
assumed. 


e The vertical stroke (|) signifies 
exclusive "or." For example, A|B means 
that the programmer may write A or B. 
Alternative operands are also indicat- 
ed, in some cases, by vertical grouping 
within braces, { }. 

e An ellipsis, ... , denotes that the 

preceding syntactical unit (which is 

enclosed in braces or brackets) can be 
written any number of times. 


* Operands are separated by commas. 


e All operands are written on one line of 
a coding sheet (except when a continua- 
tion card is necessary) even though 
they may appear on two or more lines in 
the format illustration. 


e The last operand is always followed by 
a blank. 


To determine specifically how the oper- 
ands are to be coded when substitution is 
required, a Summary of Operands is provided 
in Appendix D. This appendix contains all 
of the macro instructions and indicates the 
allowable ways of writing the operands. 
The summary is designed so that it can be 
opened with all the macro instructions 
displayed when the descriptions are being 
read. The classifications used in the 
summary are as follows: 


SYM 
is any symbol valid in the assembler 
language. 

DEC INT 


are any decimal digits up to the value 
indicated in the associated macro 
instruction description. If both SYM 
and DEC INT are checked, an absolute 
expression is also allowed. 


REGISTER 

is always coded within parentheses as 

follows: 

(2-12) - one of general registers 2 
through 12, previously loaded 
with the right-adjusted value 
or address specified in the 
associated macro instruction 
description. The unused 
high-order bits must be set 
to zero. The register may be 
designated symbolically or 
with an absolute expression. 


(1) ~ general register 1, previous-~ 
ly loaded as indicated above. 
The register can be designat- 
ed only as (1). 


RX TYPE 
any address that is valid in a RX-type 
instruction (e.g., LA) may be desig- 
nated. 


A-TYPE 

ADCON TYPE 
any address that may be written in an 
A-type address constant may be desig- 
nated. 


Whenever the L-form of a macro instruc- 
tion is specified (MF=L), no indexing or 
register notation is permitted for its 
operands; only relocatable expressions, 
absolute expressions, or codes may be used. 


Unless noted otherwise, where numeric 
values are indicated as macro instruction 
operands, these are decimal integers and 
need not be preceded by leading zeros. 


Unless otherwise specified, omission of 
the macro-form (MF) operand causes a macro 
instruction to perform both L and E func- 
tions, i.e., to derive a parameter list 


from all the operands specified and, at 
execution time, to execute the macro 
instruction using that list. 
LINKAGE CONVENTIONS 

Linkage conventions described in IBM 


System/360 Operating System; Supervisor and 


Data Management Services, Form C28-6646, 
apply to the programming support described 


here. Information about register assign- 
ments for specific linkage functions can be 
found in that publication. 


TERMINOLOGY 


In this publication, “display station 
buffer storage" refers to the buffer stor- 
age phySically located in the display con- 
trol unit. Throughout this publication, 
the unqualified term “register" means 
"general register." 
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INPUT/OUTPUT CONTROL 


Input/output control is achieved ° by 
macro instructions and associated control 
routines which together initiate input/ 


output operations associated with data dis- 
play. The input/output macro instructions 
and their functions for the IBM 2260 Dis- 
play Station are listed in Table 2. 


Note: The address of the problem program 
save area must be loaded into register 13 
before any input/output macro instruction 
is issued. 


BACKGROUND INFORMATION 


To help the reader better understand 
subsequent discussion of input/output oper- 
ations, the following paragraphs briefly 
describe the functional relationships among 
the various system control blocks associ- 
ated with 2260 input/output operations 
under the operating system. Additional 
information may be found in the “Execute 
Channel Program" section of the IBM 


System/360 Operating System; System Pro- 
grammer's Guide, Form C28-6550. 


Each data control biock (DCB) normally 
is established by a DCB macro instruction 
and completed by execution of an OPEN macro 
instruction. The DCB, which contains a 
reference to a DD statement (see below),, 
may be associated with one display station 
or with a group of display stations con- 


Single OPEN macro instruction. The OPEN 
Macro instruction creates a data extent 
block (DEB) in protected core storage. 


Included in the DEB is a table of address 
pointers to specific unit control blocks 


(UCBs) associated with the data control 
block. One UCB is specified for each 
display station and for each 1053 Printer 
attached to a 2848 Display Control. The 
ucB is used to describe its associated 


device to the control program. 


Some input/output macro instructions 
contain a "unit" operand. The “unit" oper- 
and refers to a device within a group of 
devices which can be named at system gener- 
ation time. This operand is used as an 
index to reference the desired element in 
the DEB list of UCB pointers. The value of, 
the "unit" operand, expressed as a decimal 
integer, must not exceed the number of 
devices specified on the Data Definition 
(DD) card for the data set. 


A DD statement can refer to any display 
Station or 1053 Printer singularly, or to 
any group of display stations (up to 24) 
along with a 1053 Printer connected to the 
same display control. All units of a group 
need not be specified in one DD statement; 
subsequent DD statements can refer to the 
unspecified units in that group. Informa- 
tion about data definition specifications 


can be found in IBM System/360 Operating 


nected to a single 2848 display control. System; Job Control Language, Form C28- 
More than one DCB may be completed by a 6539. 
Table 2. Input/Output Macro Instructions 
| Saas: ee ee ee eT Sa a aS aaa oa 1 
|Mnemonic|Macro Instruction Name | Function | 
|~-------}------------------------------------ }----~----------------+------------------- { 
| DCB |Data Control Block | Establishes the data control block | 
| | (DCB). | 
~------- }~-------~---------------------------}-----------------------------------------| 
| OPEN |Open Data Control Block | Initializes one or more data _ control | 
| | | blocks. | 
po ———— fn frm { 
| GREAD |Read Character Data | Transmits data from the display station | 
j | | buffer storage to main storage. | 
pm fon ~~ === =~ == === {--~--—-----~----------------------------- { 
|GWRITE |Write Character Data | Transmits data from main storage to the | 
| | | display station buffer storage or toa | 
| | | 1053 Printer. | 
}-------- }------------------------------------ }----~------------------------------------ { 
|GCNTRL |Erase Display Station Buffer Storage| Erases data from the display station | 
| | | buffer storage. | 
|-------- fanaa nn =< Eng EL GR STERNER 4 
| CLOSE {Close Data Control Block | Disassociates one or more data control | 
| | | blocks. | 
boo a I pa i ai ee J 


Table 3. Format of the DECB 

oo a ag ee Up ee a ee 1 
| Offset from | | | 
| DECB Name | | Associated I/O Macro | 
| (bytes) | DECB Field | Instruction Operand 
~--~---—--------- }--------- = - -- = -- === fn 
t +00 | Event control block (ECB) | 
| +04 | Type code | type | 
| +08 | Data control block (DCB) | dcb address | 
| | address | | 
| +12 | Area address | area address 
| +16 | Code for incorrect length or | | 
| | permanent read error | | 
| +17 | Residual count from CSW | | 
| | if incorrect length | | 
| +20 | Length (byte count) | length | 
| +24 | (Reserved) | | 
| +28 | Index to reference an element | unit | 
| | in the DEB table of address | | 
| | pointers to UCBs associated | | 
l | with the DCB | | 
| +29 | zeros (the low-order bit of this | 
| | byte is set to 1 when | | 
| | data entry type codes | | 
| | are specified.) | | 
| +30 | Zeros | | 
| +31 | Zeros | | 

L L 


The value of the "unit" operand decre- 
mented by 1 is placed in the data event 
contrcl block (DECB) when it is generated 
at macro expansion time ("“unit"™ - 1 = UCB 


index). At execution time, the Input/ 
Output Control routine places this value 
into the input/output block (IOB). This 


completes the linkage between the input/ 
output macro instruction and the selected 
UCB, which in turn points to the device 
associated with the macro instruction. 


INPUT/OUTPUT MACRO INSTRUCTIONS 


The macro instructions in this group 
implement 2260 input/output functions which 
include defining certain control blocks and 
controlling data transmission between main 
storage and the display station buffer 
storage. They provide linkage to the 
Input/Output Control routine which creates 
the ICB, constructs channel programs, and 
issues calling sequences to execute the 
channel programs. 


All input/output macro instructions ex- 
cept the DCB macro instruction may use the 
IL- and E-forms of macro definition. If all 
operands except the MF=L or MF=E keyword 


operand are written, the input/output 
function is executed using the specified 
operands. If any required operand is miss- 


ing at execution time the task is terminat- 
ed. Detailed descriptions of these forms 


and their use are found in IBM System/360 


Operating System; Supervisor and Data _ Man- 
agement Services, Form C28-6646. 


A 32-byte DECB is formed at macro expan- 
sion time and the parameters derived from 
the macro instruction operands are inserted 
into appropriate positions in the DECB. 
This data is utilized by the Input/Output 
Control routine to generate the CCWs. The 
format of the DECB for the IBM 2260 Local 
is shown in Table 3. 


Note: If an input/output operation or some 
other event depends upon the completion of 
a. previous input/output operation, a WAIT 
macro instruction should be issued immedi- 
ately following that previous input/output 


operation. The WAIT macro instruction is 
described in IBM System/360 Cperating Sys- 


tem; Supervisor and Data Management Macro 
Instructions, Form C28-6647. For the ECB 


post codes that report the completion sta- 
tus and result (i.e., successful or with 
error) of an input/output operation, see 


the System Programmer's Guide. 


DCB--Data Control Block Macro Instruction 


instruction for the IBM 
2260 Local reserves space for the data 
control block and establishes its format 
(see Tabie 4). In addition to the basic 
information required in the DCB, space is 
also reserved for addresses of the Input/ 
Output Control routine and the input/output 
block, which are supplied at open time. 
One DCB services a maximum of 24 display 
Stations and one 1053 Printer attached to 
the same display control. The format of 
the DCB macro instruction is: 


The DCB macro 
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reactor: Se a ee a 1 
| Name |Operation |Operand | 


f 4 

| (symbo1] | DcB | DSORG=GS, MACRF=code | 
| | | (,GTYPE={BASIC| EXPRESS}]_ | 
| | | (, DDNAME=ddname] | 
| | | (,EXLST=exit list address] | 
| | | £,GNCP=number of blocks] | 
L 


| | {,POLST=poll list address] | 


oa LL eed 
DSORG=GS 
specifies that a graphic data control 
block is defined. This operand is 
required for macro expansion. 
MACRF= 
specifies the type or types of macro 


instructions to be used, where R indi- 
cates GREAD, W indicates GWRITE, and C 
indicates GCNTRL. The following are 
the eight valid codes for the MACRF 
operand. 


R 

W 

RC 

WC 
(R,W) 
(RC, W) 
(R,WC) 
(RC,WC) 


GTYPE= 
specifies whether basic or express 
attention handling procedures are to 
ke employed. If this operand is omit- 


ted, express attention handling is 
assumed. 
DDNAME= 


specifies the name of the DD statement 
describing the data set being pro- 
cessed. DDNAME corresponds exactly to 
the contents of the Name field of the 
[TD statement provided in the job con- 


trol language. It can be defined by 
as many aS eight characters, the first 
of which must be a letter. DDNAME 
furnishes a logical connection between 
the DD statement and the data control 
block of the user's problem program. 


EXLST= 
specifies the address of the user's 
exit list in the problem program as 


defined in the publication IBM 


System/360 Operating System; Supervi- 
sor and Data Management Services, Form 


C28-6646. If EXLST is not specified, 
a value of zero is assumed. 

GNCP= 
specifies the maximum number of 


input/output macro instructions that 
can be issued before a WAIT macro 
instruction (i.e., the number of 
input/output blocks constructed = at 
open time). The value of GNCP must be 
from 1 to 99 at execution time. If 
the value of GNCP is not specified, a 
value of 1 is assumed. The programmer 
may specify a value of O at assembly 
time, but must respecify the value 
within the above range at execution 


time. If the value 0 is present at 
open time, the job is abnormally ter- 
minated. 

POLST= 


is the address of the location in main 
storage, reserved by the user, where a 
list of DCB addresses is constructed 
by the OPEN macro instruction. This 
list of DCB addresses, called a poil 
list, is used with express attention 
handling facilities by the OPEN, 
CLOSE, GSERV, and ANALYZ macro 
instructions as described in Appendix 
Cc of this publication. 


Table 4. Data Control Block Elements 

Ea SITS SE a a Sa a A aa a a | 
{| Offset from | | 
| DCB name | | 
| (kytes) | DCB Field | 
[-------------- }---~---------—----------------------- +--+ === === == : 
| +0-13 | Reserved | 
| +14 | GTYPE--Specifies basic or express attention handling procedures | 
| 415-25 | Reserved | 
| +26-27 | DSORG--Specifies a graphic data control block | 
| +28-31 | Reserved | 
| +32 | GNCP--Maximum number of I/O macro instructions issued before a | 
| | WAIT macro instruction is issued | 
| #33-35 | POLST--Address of list of DCB addresses used in express | 
| | attention handling | 
| +36 | Reserved | 
| +37-39 | EXLST--Address of user's exit list for exceptional conditions | 
| +40-47 | DDNAME--Corresponds to name of data definition (DD) statement | 
| +48-49 | Reserved | 
| +50-51 | MACRF--Types of I/O macro instructions used in problem program | 
a i a a a a 
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The first entry in the poll list points 
to the last entry. (It must originally be 
set to zeros.) As additional devices are 


opened, the DCB addresses are added to the 
poll list. The length of the area needed 
to construct the list is 1+#n full-words, 
where "n" is the number of devices for 
which the DCB is opened. If the user 
wishes to open multiple DCBs using the same 
OPEN macro instruction, he must use the 
same POLST operand with each DCB macro 
instruction he issues. He may use the same 
POLST operand or different POLST operands 
when issuing other OPEN macro instructions. 
If more than one poll list is created, each 
requires a separate ANALYZ macro instruc- 
tion. If POLST is not specified, a value 
of zero is assumed. This operand is used 
only with Express attention handling. 


PROGRAMMING NOTES: The user may create a 
DCB at assembly time by use of the DCB 
macro instruction. Data Definition (DD) 
card information may be supplied by the 
user at execution time. The GNCP operand 
may be specified at execution time by a DD 
card, provided GNCP is set to zero at 
assemkly time. 


The programmer can create his own DCB by 
using a constant area. In this case he may 
specify both the DSORG and GNCP operands in 
a DD card. By ensuring that this area 
contains the same information at the same 
locations as the DCB created by the DCB 
macro expansion (see Table 4), the user can 
effectively create a DCB. The DDname of 
the DD card must be identical to the DDname 
set up in this area (offset 40 through 47). 
For information on coding of the DD card, 
refer to the publication IBM System/360 


Operating System; Job Control Language. 


The data control block assembled from a 
DCB macro instruction will not have names 
associated with the individual fields that 
comprise the control block. To refer or 
gain access to the fields in the data 
control block, the user can write a DCBD 
macro instruction as follows: 


CCBD DSORG=GS 


The name field must be left blank, and only 
the DSORG operand is specified. 


The DCBD macro instruction generates a 
DSECT statement that provides a symbolic 
name for the fields within a data control 
block. Each field is defined so that with 
proper initialization of base registers, 
the user can refer to any or all fields of 
one or more data control blocks. Addition- 
al information on the DCBD macro instruc- 


tion is found in the IBM System/360 Operat- 
ing System; Supervisor and Data Management 


Macro Instructions publication. 


OPEN--Open Data Control Block Macro 


instruction 


The OPEN macro instruction for the IBM 
2260 Local initializes one or more data 
control blocks establishing a communication 
path between the problem program and the 
display station. OPEN fulfills the follow- 
ing functions: 


e Indicates that the display station is 
"open" by setting the appropriate bit 
in the DCB. 


e Fills in and initializes appropriate 
fields in the DCB. 


storage to initialize a 
chain of IOBS and associated channel 
programs. Linkage is provided in the 
IOB to its CCW list and to the next IOB 
in the chain. The number of IOBs 
constructed is one greater than the 
number specified by the GNCP operand 
(unless GNCP is equal to 99; no more 
the 99 IOBs may be constructed for each 


°® Acquires main 


DCB). The additional IOB is construct- 
ed in order to always ensure the 
availability of an IOB, since IOBs are 


not constructed dynamically. A pointer 
to the top of the chain of IOBs is 
placed in the DCB. 


® Loads the graphic I/O Control routine 
and places its address in the DCB. 


e Performs initialization functions 
required by attention-handling facili- 
ties. If the-POLST operand was speci- 
fied in the DCB macro instruction, a 
DCB address list (poll list) is con- 
structed. OPEN provides one POLST 
entry for every display station that 
the user wants polled. This function 
applies only to 2260s equipped with an 
optional keyboard feature. 


The format of the OPEN macro instruction 
is: 


Pe Ny re ere eee ee 
| Name | Operation] Operand | 

plana Ns aa a A ee Se 4 
| [symbol] | OPEN | (deb address | 
| }{,,dcb address]...) | 
| | | {,MF={L|(E,parameter | 
| | {| list name) | (E,(1))3] | 
ened ee > eee ee ee erro URE peer ane e eater yok ek neon mE ee J 


dcb address 
specifies the addresses of the DCBs to 
be initialized for the desired graphic 
device(s). Any number of DCB address- 


es may be specified. This allows 
parallel opening of DCBs_ and their 
associated data sets. If more than 


one DCB address is specified, the "dcb 
address" operands must be separated by 
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two commas. The second comma indi- 
cates omission of optional operands 
not applicable to graphic programming 
services. 


MF=1L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is the symbolic 
name specified in the Name field of 
this OPEN macro instruction. 


MF=(E,parameter list name) 

specifies that the macro instruction 
is to perform the open function using 
a parameter list created by another 
OPEN macro instruction. The open 
function is executed for each “dcb 
address" operand in the list. The 
"parameter list name“ operand must 
correspond exactly to the name speci- 
fied in the Name field of the OPEN 
Macro instruction used to construct 
the parameter list. 


MF=(E, (1)) 

performs the same function as 
(E, parameter list name). By writing 
the special register notation (1), the 
programmer specifies that he has load- 
ed the address of the parameter list 
into register 1 before execution of 
the macro instruction. 


PROGRAMMING NOTES: If the operand speci- 
fies a DCB that is already open, no action 
results. If the operand does not specify 
the address of a valid DCB when opening, 
the job is abnormally terminated. Opening 
when a corresponding DD statement has not 
been provided causes no error indication; 
however, an attempt to use the data set 
will result in an abnormal termination of 
the task. 


At execution time the OPEN routine 
checks the GNCP operand of the DCB macro 
instruction. If the value of GNCP is zero 
or greater than 99 the task is abnormally 
terminated. 


If the device specified on the DD card 
is not a graphic device, an invalid UCB 


results, andthe task is abnormally termi- 
nated. 

EXAMPLES: In the second and third exam- 
ples, DCB1 and DCB2 are initialized using 
the parameter list constructed by the first 
example. In the third example, the loca- 
tion of the parameter list has been loaded 


into register 1. 


EXAMP1 OPEN (DCB1, , DCB2) , MF=L 
EXAMP 2 OPEN MF=(E, EXAMP1) 
EXAMP 3 OPEN MF=(E, (1)) 
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GREAD-~Read Character Data Macro 
Instruction 


The GREAD macro instruction transmits 
data from the display station buffer stor- 
age to main storage. There are six possi- 
ble. read operations performed by the GREAD 
macro instruction depending upon the “type” 
operand specified. The format of the GREAD - 
macro instruction is: 


SR eRaNair as Gea ee a eS eee eee ee 1 
| Operation| Operand 


| 
a a ir anced ditt aaa inna aca aca 4 
jdecb name | 
| ,type | 
|,dcb address | 
|, Clength] | 
|,area address | 
Jj C,unit] | 


fo awe re ee ae ee ee 


decb name 
is the name assigned to the data event 
control block generated in the macro 
expansion. This operand is required 
for macro expansion. 


type 
specifies the type of read operation. 
This operand is required for proper 
macro expansion. The following are 
the valid forms of the operand (each 
"type" is described following the dis- 
cussion of all other operands related 

to the GREAD macro instruction): 

DSM 
Read Display Station Manuai Input Mes- 
sage for the 2260. 

DSMW 
Read Display Station Manual Input Mes- 
Sage Without Keyboard Restore for the 


2260. 
SMI 
Read Display Station Short Manual 
Input Message for the 2260. 
SMIW 
Read Display Station Short Manual 


Input Message Without Keyboard Restore 
for the 2260. 

DSB 
Read Full Display Station Buffer Stor- 
age for the 2260. 

DSBW 
Read Full Display Station Buffer Stor- 
age Without Keyboard Restore for the 
2260. 


dcb address 


is the address of the data control 
block associated with the graphic 
device. 

length 
is the number of data bytes to be 
read. 


area address 
is the address of the main storage 
location into which the first byte of 
data will be read. 


unit 
is a decimal integer; it is used to 
create an index to the desired element 
in the DEB table (address pointers to 
UCBS associated with the DCB). The 
indicated UCB contains the address of 
the desired device. The value of 
"unit" must be in the range 1 to WN, 
where N is the number of devices 
specified on the Data Definition card 
for this data set. N cannot exceed 25 
(the maximum configuration is 24 dis- 
play stations and one 1053 Printer per 
display control). 
Note: The device indicated by “unit" 

cannot be the 1053 Printer. 


Omission of the "unit" operand re- 
sults in the value 1 being assigned to 
"unit", indicating the first element 
in the DEB table. 


MF=-L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is the name speci- 
fied by the “decb name" operand of 
this GREAD L-form macro instruction. 


specifies 
is to perform the read operation using 
a parameter list constructed by anoth- 
er GREAD macro instruction. The first 
operand in the E-form macro instruc- 
tion must correspond exactly to the 
name of the parameter list. The pa- 
rameter list may be updated at exe- 
cution time by specifying new values 
in any of the operands preceding the 
MF=E keyword operand. 


A “type™ operand, specified in an L-form 
macro instruction, may be modified by a 
corresponding E-form macro instruction. 
Other operands required for execution that 
were not specified in an L-form macro 
instruction should be specified in the 
corresponding E-form macro instruction. 
Note: A unique name must be assigned to 
each parameter list defined. Use of the 
same DECB name for more than one DECB 
results in a multiple definition error at 
assemkly time. . 


If neither the MF=L nor MF=E keyword 
operand is written, all required operands 
must ke coded to achieve executable macro 
expansion. Omission of the “decb name" 
operand prevents macro expansion; omission 


that the macro instruction 


of other operands produce error messages on 
the assembly listing, but do not terminate 
macro expansion. 


TYPES OF READ OPERATIONS: 
read operations for the 2260 are 
below. 


The six types of 
described 


DSM (Read Display Station Manual Input 
Message): This “type” operand causes char- 


acter data in the selected display station 
buffer storage to be transferred to main 
storage by the display control. DSM can be 
used only if either optional keyboard fea- 
ture is available. Starting with the first 
display position following the Start sym- 
bol, character data will be sequentially 
retrieved and transferred until the end of 
message is detected or the channel byte 
count is reduced to zero. The Start symbol 
is then cleared. Data on the same line and 
to the right of a New Line symbol is not 
transferred. The New Line symbol is trans- 
ferred. If the Check symbol is present, it 
is transferred. The end of message code is 
not transferred to main storage, and the 
CRT data display is not changed or de- 
stroyed by the read operation. 


One channel command word is generated by 
GREAD, “type™ DSM: the Read Display Station 
Manual Input Message CCW, which initiates 
the read operation. 


DSMW_ (Read Display Station Manual Input 


Message Without Keyboard Restore): The 
operation caused by this “type” operand, 


which can only be used with IBM 2848 Models 
21 and 22, is identical to DSM, except that 
the keyboard remains mechanically locked at 
the completion of the operation. 


One channel command word is generated by 
GREAD, “type” DSMW: the Read Display Sta- 
tion Manual Input Message Without Keyboard 
Restore CCW, which initiates the read oper- 
ation. 


SMI (Read Display Station Short Manual 
Input Message): The operation caused by 


this "type" operand is identical to DSM, 
except that the Start symbol is not erased 
when the end of message is detected or the 
channel byte count is reduced to zero. 
Consequently, keyboard lockout time is sub- 
stantially less for the SMI “type"™ operand 
than for the DSM “type™ operand. This is 
an important consideration for applications 
involving a high rate of data input and 
multiple 2260s attached to one 2848. 


One channel command word is generated by 
GREAD, “type™ SMI: the Read Display Station 
Short Manual Input Message CCW, which ini- 
tiates the read operation. 


Input/Output Control 13 


SMIW (Read Display Station Short Manual 


Input Message Without Keyboard Restore): 
The operation caused by this “type" oper- 


and, which can only be used with IBM 2848 
Models 21 and 22, is identical to SMI, 
except that the keyboard remains mechani- 
cally locked at the completion of the 
operation. 


One channel command word is generated by 
GREAD, “type™ SMIW: the Read Display Sta- 
tion Short Manual Input Message Without 
Keyboard Restore CCW, which initiates the 
read operation. 


DSB (Read Full Display Station Buffer): 
This “type"™ operand causes a maximum of 


240, 480, or 960 data bytes to be trans- 
ferred, depending upon the size of the 
addressed display station buffer. The 
first symbol transferred is the first sym- 
bol in the upper left-hand corner of the 
CRT, and the last symbol transferred is the 
last symbol in the lower right-hand corner 
of the CRT. If no character is found ina 
displayable position, a space is trans- 
ferred. If the addressed buffer has the 
optional non-destructive cursor feature, 
the cursor position is not indicated by the 
data transferred. If the addressed buffer 
has a standard destructive cursor feature, 
the cursor position is indicated by the 
location of the end of message code. The 
Check and Start symbols are transferred if 
they are present. The codes are: 


bit 01234567 

Destructive cursor 011031010 

Check symbol 011121111 

Start symbol 01001010 
The CRT is erased after the operation, 


and the cursor is placed in the first 
cursor position (upper left-hand corner) of 
the CRT. 


‘Multiple channel command words are gen- 
erated by GREAD, “type™ DSB. First, the 
Read Full Display Station Buffer CCW is 
issued, which initiates the read operation. 
Second, the Erase Display Station Buffer 
Storage CCW is issued, which deletes all 
character data from the display station 
buffer storage and resets the cursor to the 
first display position of the CRT. 


DSBW. (Read _ Full Display Station Buffer 


Without Keyboard Restore): The operation 
caused by this “type"™ operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to DSB, except that the 
keyboard remains mechanically locked at the 
completion of the operation. 


‘Multiple channel command words are gen- 
erated by GREAD, “type™ DSBW. First, the 
Read Full Display Station Buffer Without 
Keyboard Restore CCW is issued, which ini- 
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tion and delete the Start symbol. 


tiates the read operation. Second, the 
Erase Display Station Buffer Storage With- 
out Keyboard Restore CCW is issued, which 
deletes all character data from the display 
station buffer storage and resets the cur- 
sor to the first display position of the 


CRT. 

PROGRAMMING NOTES: If the channel byte 
count in the CCW reaches zero, a Stop 
sequence is generated by the channel. Dur- 


ing a read operation, receipt of the Stop 
sequence terminates transmission of data 
from the display control to main storage. 
The display control continues reading data 
from the display station buffer storage but 
does not transfer data to main storage. 
Detection of the end of message when using 
DSM causes the display control to restore 
the keyboard of the selected display sta- 
When SMI 
is used, the keyboard is restored and the 
Start symbol is not erased. When DSB is 
used, the display is erased at completion 
of the operation, and the cursor is reset. 
If an error is detected during execution of 
DSB, the erase operation is not performed. 
The problem programmer, therefore, should 
ensure that the correct length is specified 
if he wants the erase operation to be 
performed. 


An unspecified “length" operand or zero 
entry results in the insertion of a byte 
count of 960 in the generated CCW. This 
assures that the Stop sequence will not be 
encountered on read operations. If the 
"length" operand is incorrectly specified, 
an error message is printed on the assembly 
listing. 
ERROR 


CONDITIONS: If incorrect length 


occurs during execution, the count from the 


CSW is placed in its appropriate location 
in the DECB (DECBt17 through 19), anda 
hexadecimal code of 43 is posted in the 
DECB (DECBt16). Since this case is not 
considered an error, a hexadecimal code of 
7F is also posted in the high-order byte of 
the ECB. If a permanent read error occurs, 
a hexadecimal code of 45 is posted in the 
DECB (DECBt16) and a hexadecimal code of 41 
is also posted in the high-order byte (byte 
0) of the ECB. If a read error occurs 
during a read manual input operation (DSM, 
DSMW, SMI, or SMIW), the screen is erased, 
the message ERROR ON READ is displayed, and 
an error code is posted in the high-order 
byte (byte 0) of the ECB. Automatic retry 
is not provided and the handling of the 
error is entirely the responsibility of the 
user. 


Before processing the data obtained from 
a read operation, the program should always 
check DECB bytes 16 through 19 to determine 
the completion condition. If the DECB is 
to be used for more than one input/output 


ee eee Se ae ea ee 1 


T 
{Read Operation | 


Table 5. Completion Indications and Conditions 
Ce ne aa ee oc ee 

| Indication | Condition 
}---------—-----_----—---_-4 ------_--_-~.-----__----- 


1. DECBt+16=0 
DECB+17=not used 


N 
e 


| 

| 
DECB+16=45 |Permanent Error 

DECB+17=not used | 

| 

| 


DECBt16=43 
DECB+17=0 
CSW count=0 


(es) 
e 


|buffer was read) 


DECB+16=43 
DECB+17=count 
CSW count not equal 


£ 
s 


not zero 


| 
5. DECB+16=43 ja. The 


DECBt+17=initial count| 


cette ner re eee ees cee eee mee eee cee cee a es aD ee SE eee eS ae eas one 


operation the user must zero DECB byte 16 
before execution of the next input/output 
operation. The indications and conditions 
present when determining the completion 
condition, and the read operation affected, 
are shown in Table 5. 


If the data control block address is not 
the address of a valid DCB, or if a 
required operand is missing, the task is 
abnormally terminated. 


EXAMPLES: In the following example, a DECB 
named DECB1 is to be generated as part of 
the macro expansion. The “type™ operand 
specifies that a DSM operation for the data 
set associated with the data control block 
INDCB will be performed. A length of 100 
bytes will be read into an area in main 
storage called INAREA. The value of the 
*unit™ operand is 1. In example 1 L-form 
is specified, which generates the parameter 


list. Example 2 shows coding when posi- 
tional operands are omitted in an L-form 
GREAD. Example 3 shows the E-form GREAD 


with the length changed to 150 bytes. 


EXAMP1 GREAD DECB1, DSM, INDCB, 100, 
INAREA, 1,MF=L 
EXAMP2 GREAD DECB1, DSM, MF=L 


EXAMP3 GREAD DECB1,,,150,MF=E 


Register Notation: The programmer may spec- 
ify register notation, in which case the 
address of the DECB must be loaded into 
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| 

| 

| 

| 

| 

| 

| 

|Long Length Record | 
| (The CSW count reached zero before the end of | 
|message symbol was detected) | | 
|(The CSW count reached zero before the full |DSB or DSBW | 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

Jj 


| 

{Short Length Record 
|(The end of message 
| before the CSW count reached zero) 

to initial count and |(The full buffer was read before the CSW |DSB or DSBW 
|count reached zero) 


ENTER key was 
Start symbol was not on the screen 
jb. A DSM was given when the ENTER key had | 
| not been depressed 


| 
|DSM, DSMW, 
symbol was encountered |SMI or SMIW 


| 
|DSM, DSMW, SMI 
jor SMIW 


depressed when the 


register 1 before execution of the macro 
instruction. Other positional operands may 
be loaded into other registers (2-12). For 
example: 


EXAMP1 LA 1,DECB 
GREAD (1) ,MF=E 
or 
EXAMP2 LA 1,DECB1 
LA 2, INDCB 
LA 3, INAREA 
GREAD (1),,(2),, (3) ,MF=E 


When expressing the “unit" operand in 
register notation, the value loaded into 
the register is the same as the UCB index 
(unit-1), and is placed in the high-order 
byte of the register. 


GWRITE--Write Character Data Macro 
Instruction 


The GWRITE macro instruction transmits 
data from main storage to the display 
Station buffer storage or to a 1053 Print- 
er. There are eight possible write opera- 
tions performed by the GWRITE macro 
instruction depending upon the "type" oper- 
and specified. The format of the GWRITE 
macro instruction is: 
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Name | Operation |Operand | 


~~—- -~-~4-——------—- + -- ----- -----—-- -----—-f 


| [symbol] | GWRITE |decb name 


| |,type 
| |,dcb address 


| fC, unit) 
| | (, MF={L| E}] 


ee Se See ee | 


| 
| | 
| | 
| | |, Clength] | 
| | |,area address | 
| | | 
| | 
L 


decb name 
is the name assigned to the data event 
control block generated in the macro 
expansion. This operand is required 
for macro expansion. 


type 

specifies the type of write operation. 
This operand is required for proper 
macro expansion. The following are 
the valid forms of the operand (each 
"type" is described following the dis- 
cussion of all other operands related 
to the GWRITE macro instruction): 

DSB 
Write Display Station Buffer Storage 
for the 2260, or Write 1053 Printer 
Buffer Storage for the 1053. 

DS BW , 
Write Display Station Buffer Storage 
Without Keyboard Restore for the 2260. 

EBW 
Erase and Write Display Station Buffer 
Storage for the 2260. 

EBWW 
Erase and Write Display Station Buffer 
Storage Without Keyboard Restore for 
the 2260. 

LNE 
Write Display Ctation Line Address for 
the 2260. 

LNEW 
Write Display Station Line Address 
Without Keyboard Restore for the 2260. 

EWL 
Erase and Write Display Station Line 
Address for the 2260. 

EWLW 
Erase and Write Display Station Line 
Address Without Keyboard Restore for 
the 2260. 


dcb address 
is the address of the data 
klock associated with a 
device. 


control 
graphic 


length 
is the number of bytes of display data 
to be written. This includes the New 
Line character and the Line Address 
control byte when used. 
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area address 
is the address of the main storage 
location from which the first byte of 
display data is to be written. 


unit 

is a decimal integer; it is used to 
create an index to the desired element 
in the DEB table (address pointers to 
UCBS associated with the DCB). The 
indicated UCB contains the address of 
the desired device. The value of 
"unit" must be in the range 1 to N, 
where N is the number of devices 
specified on the Data Definition card 
for this data set. N cannot exceed 25 
(the maximum configuration is 24 dis- 
play stations and one 1053 Printer per 
display control). 


Note: The 1053 Printer can be indicat- 
ed by “unit"™ only when the "type" 
operand is written as DSB. 


Omission of the “unit" operand 
results in the value 1 being assigned 
to "unit", indicating the first ele- 
ment in the DEB table. 


MF=-L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is specified by the 
"decb" operand of this GWRITE L-form 
Macro instruction. 


MF=E 

specifies that the macro instruction 
is to perform the write operation 
using a parameter list constructed by 
another GWRITE macro instruction. The 
first operand in the E-form macro 
instruction must correspond exactly to 
the name of the parameter list. The 
parameter list may be updated at exe- 
cution time by specifying new values 
in any of the operands preceding the 
MF=E operand. 


A “type” operand, specified in an L-form 
macro instruction, may be modified by a 
corresponding E-form macro instruction. 
Other operands required for execution that 
were not specified in an L-form macro 
instruction should be specified in the 
corresponding E-form macro instruction. 


Note: A unique name must be assigned to 
each parameter list defined. Use of the 
same DECB name for more than one DECB 


results in a multiple definition error at 
assembly time. 


If neither the MF=L nor MF=E keyword 
operand iS written, all required operands 
must be coded to achieve executable macro 
expansion. Omission of the "“decb name" 


operand prevents macro expansion; omission 
of other operands produce error messages on 
the assembly listing, but do not terminate 
macro expansion. 


TYPES OF WRITE OPERATIONS: 
of write operations for the 
scribed below. 


The eight types 
2260 are de- 


DSB (Write Display Station Buffer Storage): 
This “type" operand causes sequential bytes 


of character data to be transmitted to the 
display control in either of two modes 
depending upon whether the address is spec- 
ified as display station or 1053 Printer. 


Upon recognition of the display station 
address by the display control, character 
data is placed into the display station 
buffer storage starting at the cursor sym- 
bol position. The cursor is automatically 


advanced to the next cursor position. The 
cursor is placed in the first display 
position (upper left-hand corner) of the 


CRT when a displayable character is insert- 
ed into the last display position of the 
CRT. 


When the 1053 Printer address is recog- 
nized by the display control, incoming 
character data is placed into contiguous 
print positions of 1053 buffer storage and 
the 1053 print operation is initiated. A 
New Line character should be inserted at 
least after every 130th character; other- 
wise, oOverprinting results. 


If a write error occurs during execution 
of a GWRITE, “type™ DSB, operation, the 
system error recovery procedure erases the 
screen completely before initiating a 
retry. 


One channel command word is generated by 
GWRITE, “type™ DSB: the Write Display Sta- 
tion Buffer Storage CCW, which initiates 
the write operation. 


DSBW. (Write Display Station Buffer Storage 


Without Keyboard Restore): The operation 
caused by this "“type™ operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to DSB, except that the 
keyboard remains mechanically locked out at 
the completion of the operation. 


One channel command word is generated by 


GWRITE, "“type"™ DSBW: the Write Display 
Station Buffer Storage Without Keyboard 
Restore CCW, which initiates the write 


operation. 


EBW (Erase and Write Display Station Buffer 
Storage): This “type™ operand causes the 


display control to delete all character 
data from the display station buffer stor- 
age, and to reset the cursor to the first 
display position (upper left-hand corner) 


of the CRT. The display data is then 
placed into display station buffer storage, 
starting with the position at which the 
cursor is reset. 


Two channel command words are generated 
by GWRITE, “type" EBW. First, the Erase 
Display Station Buffer Storage CCW is 
issued to delete all character data from 
the display station buffer storage and 
reset the cursor to the first display 
position of the CRT. Second, the Write 
Display Station Buffer Storage CCW is 
issued to initiate the write operation. 


EBWW (Erase and Write Display Station Buf- 
fer Storage Without Keyboard Restore): The 


operation caused by this "type" operand, 
which can only be used with the IBM 2848 
Models 21 and 22, is identical to EBW, 
except that the keyboard remains mechani- 
cally locked at the completion of the 
operation. 

Two channel command words are generated 


by GWRITE, “type" EBWW. First, the Erase 
Display Station Buffer Storage Without Key- 
board Restore CCW is issued to delete all 
character data from the display station 
buffer storage and reset the cursor to the 
first. display position of the CRT. Second, 
the Write Display Station Buffer Storage 
Without Keyboard Restore CCW is issued to 
initiate the write operation. 


LNE (Write Display Station Line Address): 
This "type" operand, which can only be used 


if the Line Addressing speciai feature is 
available, causes the display control to 
transmit sequential bytes of character data 


into the display station buffer storage 
under channel byte count control. The 
Starting location in the display station 


buffer storage, as indicated in the first 
data byte, is interpreted as a control 
byte. This byte specifies the line to 


which the display data will be transmitted 
(see Table 6). The cursor is moved to the 
first display position of the line indicat- 


ed and display data is placed into display 
station buffer storage starting at the 
position of the cursor symbol. The cursor 


is automatically advanced to the next dis- 
play position. 


LNE executes essentially the same opera- 


tion as DSB. The basic difference is that 
information in the first data byte (a 
hexadecimal value in the range FO through 


FB), which must be supplied by the user, 
specifies the line to which the display 
data will be transmitted. 


One channel command word is generated by 
GWRITE, “type” LNE: the Write Display Sta- 
tion Line Address CCW, which initiates the 
write operation. 


Input/Output Control 17 


Table 6. Format of First Data Byte for 


Line Addressing Operations 


US re ee Oe ee ee GM ee ee bee Te ei ei gh 


| Bit Positions | Hex. | Selected | 
{01234567 | Equiv. | Line | 
p-----——-----— —- }--- --—- f ——--f 
}11110000 | FO | one | 
1112110001 F1 | two | 
Ua 2k 0) 00 | F2 | three | 
}11110011 | F3 | four | 
111110100 | F4 | five | 
}$112110101 | F5 | six | 
{}/12112112120110 4f F6 | seven | 
|) ead aed OA a ‘F7 | eight | 
{11111000 | F8 | nine | 
111111001] F9 | ten | 
111111010 | FA | eleven | 
{121121111011 | FB | twelve | 
Ba oe ee ee eed 


LNEW (Write Display Station Line Address 


Without Keyboard Restore): The operation 
caused by this “type™ operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to LNE, except that the 
keyboard remains mechanically locked out at 
the completion of the operation. 


One channel command word is generated by 
GWRITE, “type"™ LNEW: the Write Display 
Station Line Address Without Keyboard Re- 
store CCW, which initiates the write opera- 
tion. 


EWL (Erase and Write Display Station Line 
Address): This “type™ operand, which can 


be used only if the Line Addressing special 
feature is available, causes the display 
control to delete all character data from 
the display station buffer storage, and 
resets the cursor to the first display 
position (upper left-hand corner) of the 
CRT. The cursor is moved to the first 
display position of the specified line and 
the display data is placed into the display 
station buffer storage starting at the 
position of the cursor symbol. The cursor 
is automatically advanced to the next dis- 
play position. 


EWL executes the same operation as LNE, 
except that an erase operation is performed 
first. 


Two channel command words are generated 
by GWRITE, “type" EWL. First, the Erase 


Display Station Buffer Storage CCW is 
issued to delete all character data from 
the display station buffer storage and 


reset the cursor symbol. Second, the Write 
Display Station Line Address CCW is issued 
to initiate the write operation. 


EWLW. (Erase and Write Display Station Line 


Address Without Keyboard Restore): The 
operation caused by this “type™ operand, 


which can only be used with the IBM 2848 
Models 21 and 22, is identical to EWL, 
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remains mechani- 
completion of the 


except that the keyboard 
cally locked at the 
operation. 


Two channel command words are generated 
by GWRITE, "“type"™ EWLW. First, the Erase 
Display Station Buffer Storage Without Key- 
board Restore CCW is issued to delete all 
character data from the display station 
buffer storage and reset the cursor symbol. 
Second, the Write Display Station Line 
Address Without Keyboard Restore CCW is 
issued to initiate the write operation. 


PROGRAMMING NOTES: If the data control 
block address is not the address of a valid 
DCB, or if a required operand is missing, 
the job is abnormally terminated. 


ERROR CONDITIONS: A normal completion is 
indicated by a hexadecimal code of 7F in 
the high order byte of the ECB (byte 0). 
If a permanent error occurs, a hexadecimal 
code of 41 is posted in this byte. 


EXAMPLES: In the following examples, a 
DECB named DECB1 is to be generated as part 
of the macro expansion. The “type" operand 
specifies a DSB operation for the data set 
associated with the data control block 
OUTDCB. One hundred bytes of data will be 
written from an area in main storage called 
OUTAREA. The value of the “unit"™ operand 
is 1. In Example 1, L-form is specified to 
generate the parameter list. Example 2 
shows coding for an L-form GWRITE macro 
instruction when positional operands are 
omitted. Example 3 shows coding for an 
E-form GWRITE macro instruction with the 
length changed to 150 bytes. 

EXAMP1 GWRITE DECB1,DSB,OUTDCB,100, 
OUTAREA,1,MF=L 


EXAMP2 GWRITE DECB1,DSB,MF=L 


EXAMP3 GWRITE DECB1,,,150,MF=E 


Register Notation: The programmer may spec- 
ify register notation. The address of the 


DECB must be loaded into register 1 before 
execution of the macro instruction. Other 
positional operands may be loaded into 
other registers (2-12). For example: 


EXAMP1 LA 1,DECB1 
GWRITE (1) ,MF=E 
or 
EXAMP2 LA _ 1,DECB1 
LA 2,OUTDCB 
LA 3, OUTAREA 
GWRITE (1),,(2),, (3) ,MF=E 


When expressing the "unit" operand in 
register notation, the value loaded into 
the register is the same as the UCB index 


(unit-1), and is placed in the high-order 
byte of the register. 


GCNTRL--Erase Display Station Buffer 
Storage Macro Instruction 


The GCNTRL macro instruction erases data 


from the display station buffer storage. 
There are two possible erase operations 
performed by the GCNTRL macro instruction 


depending upon the 
fied. The format of the 
instruction is: 


"type" operand speci- 
GCNTRL macro 


Bee ee eae Te ea re ee 1 
| Name | OQ(peration|Operand | 


a ae ae ae ee fe —--—--—--—-—--—------—----| 


| (symbol) | GCNTRL |decb name | 
| | |,type | 
| |,dcb address | 
| }{, unit] | 
| | (,MF={L| E}] | 
1 L 


decb name 
is the name assigned to the data event 
control block. This operand is re- 
quired for macro expansion. 


type 

specifies the type of 
tion. This operand is required for 
proper macro expansion. The following 
are the valid forms of the operand 
(each “type™ is described following 
the discussion of all other operands 
related to the GCNTRL macro in- 
struction): 

ERS 
Erase Display Station Buffer Storage 
for the 2260. 

ERSW 
Erase Display Station Buffer Storage 
Without Keyboard Restore for the 2260. 


control opera- 


dcb address 


is the address of the data control 


block associated with the graphic 
device. 

unit 
is a decimal integer; it is used to 


create an index to the desired element 
in the DEB table (address pointers to 
UCBs associated with the DCB). The 
indicated UCB contains the address of 
the desired device. The value of 
"unit" must be in the range 1 toN, 
where N is the number of devices 
specified on the Data Definition card 
for this data set. WN cannot exceed 25 
(the maximum configuration is 24 dis- 
play stations and one 1053 Printer per 
display control). 


Note: 
*unit"™ 


The device indicated by the 
operand cannot be the 1053 


TYPES OF CONTROL OPERATIONS: 


Printer, since an erase operation is 
invalid for the 1053 Printer. 


Omission of the "“unit" operand 
results ina value of 1 being assigned 
to "unit", indicating the first ele- 
ment in the DEB table. If "unit" is 
incorrectly specified, an error mes- 
sage is printed on the assembly list- 
ing. 


MF=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list. only. The name assigned to 
the parameter list is the name speci- 
fied by the “decb name" operand of 
this GCNTRL L-form macro instruction. 


MF=E 

specifies the macro instruction is to 
perform the erase function using a 
parameter list constructed by another 
GCNTRL macro instruction. The first 
operand in the E-form macro instruc- 
tion must correspond exactly to the 
name of the parameter list. The pa- 
rameter list may be updated at execu- 
tion time by specifying new values in 
any of the operands preceding the 
keyword operand. 


A “type™ operand, specified in a L-form 
macro instruction, may be modified by a 
corresponding E-form macro instruction. 


Other operands required for execution that 
were not specified in an L-form macro 
instruction should be specified in the 
corresponding E-form macro instruction. 


Note: If neither the MF=L nor MF=E keyword 
operand is written, all required operands 
must be coded to achieve executable macro 
expansion. Omission of the "“decb name" 
operand prevents macro expansion; omission 
of other operands produce error messages on 
the assembly listing, but do not terminate 
Macro expansion. 


The two types 


of control operations for the 2260 are 


described below. 


ERS (Erase Display Station Buffer Storage): 


This "“type" operand causes the display 
station to delete all character data from 
the display station buffer storage. The 


cursor symbol is placed in the first dis- 
play position of the CRT (upper ieft-hand 
corner), and the remainder of the display 
is blank. 


GCNTRL, “type" ERS, generates one chan- 
nel command word, the Erase Display Station 
Buffer Storage Control CCW, which initiates 
the erase operation. 
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ERSW (Erase Display Station Buffer Storage 


Without Keyboard Restore): The operation 
caused by this "type" operand, which can 


only be used with IBM 2848 Models 21 and 
22, is identical to ERS, except that the 
keyboard remains mechanically locked out at 
the completion of the operation. 


One channel command word is generated by 
GCNTRL, “type™ ERSW: the Erase Display 
Station Buffer Storage Control Without Key- 
board Restore CCW, which initiates the 
erase operation. 


PROGRAMMING NOTES: If the data control 
block address is not the address of a valid 
DCB, or if a required operand is missing, 
the job is abnormally terminated. 


ERROR CONDITIONS: A normal completion is 
indicated by a hexadecimal code of 7F in 
the high order byte of the ECB (byte 0). 
If a permanent error occurs, a hexadecimal 
code of 41 is posted in this byte. 


EXAMPLES : In the coding below, a DECB 
named DECB1 is to be addressed. The "type" 
operand specifies that an ERS operation for 
the data set associated with the data 
control block OUTDCB will be performed. 
The value of the “unit™ operand is 1. 
L-form is specified in Example 1. Example 
2 shows coding for an L-form GCNTRL macro 
instruction when positional operands are 
omitted. Example 3 shows coding for an 
E~form GCNTRL macro instruction when a 
positional operand is changed. 


EXAMP1 GCNTRL DECB1, ERS, OUTDCB,1, 
MF=L 
EXAMP2 GCNTRL DECB1, ERS, MF=L 


EXAMP3 GCNTRL DECB1,,,4,MF=E 


Register Notation: The programmer may spec- 
ify register notation. In such cases he 
must load the address of the DECB into 
register 1 before execution of the macro 
instruction. Other positional operands may 
be loaded into other registers (2-12). For 
example: 


EXAMP1 LA 1, DECB1 
GCNTRL (1) ,MF=E 

or 

EXAMP2 LA 1, DECB1 
LA 2,4 
SLL 2,24 
GCNTRL (1),,,(2),MF=E 

When expressing the "“unit"™ operand in 


register notation, the value loaded into 


the register is the same as the UCB index 
(unit-1), and is placed in the high-order 


byte of the register. 
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CLOSE--Close Data Control Block Macro 
Instruction 


The CLOSE macro instruction disasso- 
ciates one or more data control blocks from 
the user's program breaking the communi- 
cation path between the problem program and 
the display station. CLOSE fulfills the 
following functions: 


e Indicates that the DCB for the 
Station is "“closed" by 
appropriate bit in the DCB. 


display 
setting the 


e Releases main storage acquired at open 
time, including the chain of IOBs and 
associated channel programs, as well as 
storage acquired for attention handling 


functions. 

e Clears the fields in the DCB initial- 
ized at open time. 

e Deletes attention routines loaded by 


the "open" functions. (Basic attention 


handling only) 


e Removes entries from the DCB address 


list (poll list) constructed at open 
time. (Express attention handling 
only) 
The format of the CLOSE macro instruc- 
tion is: 
Sa ho ae Te = ee 1 
| Name | Operation|Operand | 
-~--~----}--------- 4----------------------4 
| [symbol] | CLOSE | (dcb address | 
| | | {,,dcb address]...) | 
| { j(,MF={L|] (E,parameter | 
| | {| list name) |(E,(1))3] | 
eee Leino eons Bhan ener vara oe ae mar aed ae eNO eS 


dcb address 

specifies the addresses of the DCBs 
for the graphic device(s) being 
closed. Any number of DCB addresses 
may be specified. If more than one 
DCB address is specified, the "dcb 
address" operands must be separated by 
two commas. The second comma indi- 
cates omission of an optional operand 
pertaining to volume disposition, as 
explained in the Control Program Ser- 
vices publication. 


MF=L 
specifies that expansion of the macro 
instruction is to consist of a parame- 
ter list only. The name assigned to 
the parameter list is the name speci- 
fied in the Name field of this CLOSE 
macro instruction. 


MF=(E,parameter list name) 
specifies that the macro instruction 
is to perform the close functions 


using a parameter list constructed by 
another CLOSE macro instruction. The 
close function is executed for each 
“dcb address" operand in the list. 
"Parameter list name“ must correspond 
exactly to the name specified in the 
Name field of the CLOSE macro instruc- 
tion used to construct the parameter 
list. 


MF=(E, (1)) 

performs the same function as 
(E,parameter list name). By writing 
the special register notation (1), the 
programmer signifies that he will load 
the address of the parameter list into 
register 1 before macro instruction 
execution. 


PROGRAMMING NOTES: If the operand speci- 
fies a DCB that is already closed, no 
action results. If the operand does not 
specify the address of a DCB, the task is 
abnormally terminated. 


Modifying the DECB at Execution Time 


Required parameters in the DECB may be 
modified at execution time by using an 
E-form macro instruction. The following 
programming considerations apply: 


1. Register notation may be 
The register is loaded 


specified. 
with the 


appropriate parameter before execution — 


of the macro instruction. 


2. In using register notation, registers 
2 through 12 should be used except for 
the “decb name" operand. Register 1 
must be used for it. 


3. If the "“type™ operand is changed, it 
should only be specified by using an 
E-form macro instruction containing 
the new “type™ code. Register nota- 
tion is not allowed for the "type" 
operand. 


Upon completion of an input/output oper- 
ation, the completion flag in the event 
control block is set to 1. If an ECB is 
used for more than one input/output opera- 
tion, it is the problem programmer's re- 
sponsibility to set the completion flag to 


0 before execution of the second input/ 
output operation and all subsequent 
input/output operations that refer to that 
ECB « The following illustration shows the 
position of the completion flag in the ECB. 


a Sohal aa. SS a a 1 
ECB { | 1 | | | 
Seon, eA areas eee enn aN ARE RE ee ae J 
bits 0 1 2 31 


Assume, for example, that a data event 
control block named DECB1 is to be used for 
two read operations. The second GREAD 
macro instruction can be preceded by the 
following line of code to clear the comple- 
tion flag in the ECB. 


NI DECB1,X'BF' 


MVT Considerations 


The following rules apply to the use of 
input/output macro instructions in an MVT 
environment, where basic attention handling 
facilities are used. 


e A graphic device that has been opened 
by one task must be closed by the same 
task. Any task attempting to open or 
close a device that has been opened by 
another task, and not subsequently 
closed, will be abnormally terminated. 
(Note that this applies to the graphic 
device, not the DCB.) 


e Within a single task, a graphic device 
May be opened more than once in succes- 


Sion (i.e., without being closed after 
each open). A different DCB must be 
used each time, however. 


e A task may issue input/output macro 
instructions (GREAD, GWRITE, GCNTRL) 
for a DCB that has been opened by a 
subtask or by an originating task. 
However, if the task that opened the 
DCB closes the DCB before the 
input/output function is completed, the 
task issuing the input/output macro 
instruction may be abnormally terminat- 
ed. Synchronization of open, close, 
and input/output functions is the 
user's responsibility. 
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BASIC ATTENTION HANDLING 


The operator at the 2260 Display Station 
can communicate information to the system 
through use of a keyboard. Input from the 
keyboard results in an attention (an 
unscheduled input/output interruption). In 
order for such input to be meaningful, 
there must exist a routine, or routines, to 
be entered upon receipt of an attention. 


Under basic attention handling the con- 
trol program automatically detects the 
occurrence of an attention and passes con- 
trol to the correct user-written routine. 
The user must supply information to the 
control program concerning what routines 
are available to handle the various atten- 
tions and from which display stations. 
Macro instructions, described in this sec- 
tion, are provided which enable the user to 
notify the system of the routines availabie 
for attention handling. This gives the 
programmer a high degree of control over 
the total attention handling mechanism. 
The wacro instructions and their functions 
are listed in Table 7. 


FUNCTIONS OF BASIC ATTENTION HANDLING 


Basic attention handling provides’ the 
facilities to: 


e Detect the occurrence of attentions 
automatically. 
e Route these attentions to the user's 


attention handiing routines. 


e Queue succeeding attentions, if neces- 
sary, until their routine is ready to 
process them. 


active or available. 


e Wait for expected attentions, optional- 
ly continuing selective processing in 
the meantime. 


Particular advantages of basic attention 
handling are: 


e Attentions are not lost if the routine 
designed to handle them is responding 


to an earlier attention at the time 
they are received. 
e Processing may be overlapped with 


attention input and/or 


sponse time. 


operator re- 


e System overhead is reduced, since there 
is no need to continually check for 
attentions. 


BACKGROUND INFORMATION 


When the control program detects an 
attention from a 2260, it interrupts the 
currently processing routine (which may be 
an attention routine) and places the atten- 


tion data on the queue of the highest 
priority attention routine for the device 
originating the attention that is either 


(To be available, a 
routine must be designated by a SAEC macro 
instruction for entry on receipt of a 2260 
attention, and the associated GACB must 
have been specified by a SPAR macro 
instruction and not subsequently deleted by 
a DAR macro instruction; see below. An 


active routine is one that is in control or 


Table 7. Basic Attention Handling Macro Instructions 
[eae ee Ms cee eee eS ee eee 
|Mnemonic|Macro Instruction Name 

}~------- 4---~-—~--~--~---------~------------ 
| SAEC |Specify Asynchronous Entry 

| | Conditions 

| | 

[-----—- }~------~-----~--~---------~-------- 
| SPAR |Specify Attention Routine 

| | 

[-~~-~--~~ }~------~-----~-----------—------—-- 
| DAR |Delete Attention Routine 

| | 

|~-----—~ 4-~-----~-—--——---~---—--- 
|ATTNINO |Attention Inquiry 

| | 

| | 

bog (ger eee ROS Ree apd a eR are ERT ee ER 


PU ae ae ee er ra er ga 1 
| Function | 
4-~------------------------------------—-- { 
| Defines an attention-handling routine | 
| and specifies the exact conditions that | 
| will cause entry to the routine. | 
}-----—-------~--------------------------- { 
| Makes attention handling routines | 
| available for system use. | 
}------~---------------------------------- { 
| Makes attention handling routines un- | 
| available for system use. | 
4~--~---~--------------------------------- { 
| Allows communication between an atten- | 
| tion handling routine and the control | 
| program. | 
a ss I eA a a eT Ce OE EE SET J 


has been interrupted.) If no attention 
routine for the device is available (or 
active), the attention is lost. In either 
case, control then returns to the user's 
progran. If the routine obtaining the 
queued attention had previously been 
inactive, it receives control; otherwise, 
control reverts to the routine just inter- 
rupted. 


When an attention routine is in control, 
it processes the attentions on its queue in 
the order in which they occurred, unless an 
ATTNINQ macro instruction within the rou- 
tine instructs it to examine the queue for 
attentions from a particular display sta- 
tion. 


When an attention routine relinquishes 
control (by means of the R mode of the 
ATTNINQ macro instruction, or by executing 
a RETURN), any attention remaining on its 
queue is serviced before the routine 
becomes inactive. Attentions may, however, 
be released from the queue without being 
serviced; this is done by the CLEAR mode of 
the ATTNINQ macro instruction. 


BASIC ATTENTION HANDLING MACRO INSTRUCTIONS 


Macro instructions in this group allow 
the user to define his attention handling 
capability to the system. The user can 
designate one attention handling routine to 
service attentions from ali the graphic 
devices engaged in a task, or he can 
provide separate routines for individual 
devices. The SAEC, SPAR, and DAR macro 
instructions are used to determine the 
status of his attention handling routines. 
The ATTNINQ macro instruction completes the 
set furnished by basic attention handling. 


SAEC--Specify Asynchronous Entry Conditions 
Macro Instruction 


The SAEC macro instruction defines an 
attention handling routine by creating a 
parameter list called a graphic attention 
control block (GACB). The GACB- contains 
information that identifies the attention 
handling routine, relates it to a 2260, 
specifies the entry point of the routine, 
and specifies the type or types of atten- 
tions to cause entry to the routine. The 
GACB can subsequently be referred to by the 
symbolic name of the SAEC macro instruc- 
tion. The format of the SAEC macro 
instruction is: 


en nt er ee nn7y 


| Name |Operation|Operand | 


+ 

| (CEP={entry point address|0}] | 
|€,DCB=dcb address] | 
| (, COMAREA=communication area address] | 
| (, ATTNTYP={({A|S]R},2260) |SAVE| RESTORE}] | 
| C€,MF={L](E, gacb address) }] 

fet ad ce a ad 


-——— — 


EP= 

specifies the entry point of an atten- 
tion routine. If this operand is 
omitted, or specified equal to zero 
(which is equivalent), any attentions 
for the routine will be queved but not 
processed until such time as an entry 
point is supplied or until the queue 
is examined by means of an ATTNINO 
macro instruction. 


DCB= 
specifies the address of a DCB asso- 
ciated with the display station, or 
group of display stations, from which 
attentions are to be serviced. 


COMAREA= 
specifies the address of a programmer- 
defined area in main storage, aligned 
on a full-word boundary and at least 
16 bytes long, which is to be used by 
the control program to pass attention 
information to the attention routine. 


ATTNTYP= 
specifies 
will cause 
routine. 


the type of attention that 
entry to the attention 


A, S, or R 

specify, respectively, whether the 
information that follows is to be 
added to or subtracted from, or is to 
replace, the existing ATTNTYP field in 
the GACB. If this operand is omitted 
from an E-form of the macro instruc- 
tion, R is assumed. 


2260 
specifies that the routine is to ser- 
vice attentions originating from a 
2260. 


SAVE, RESTORE 
specify, respectively, that the con- 
tents of the ATTNTYP field of the GACB 
are to be stored, or are to be 
replaced with the mask saved by a 
previous SAEC macro instruction with 
an ATTNTYP=SAVE operand. 


Note: The codes A, S, R, SAVE, and RESTORE 
are provided for compatibility with other 
graphic devices, which may allow for more 
than one type of attention. 


MF=L 
specifies that the macro instruction 
is to construct a GACB utilizing the 
specified operands. Operands omitted 
from the L-form cause the associated 
fields to be set to zeros. If neither 
the L- nor E-form is specified, L is 
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assumed. A, 5S, R, SAVE, and RESTORE 
are not relevant when the L-form of 
this macro instruction is used. Omis- 
sion of the A, S, or R operand need 
not be indicated with a comma. 


MF=E 

causes the GACB established by an 
L-form of this macro instruction to be 
modified, as indicated by the other 
operands. If an operand is omitted, 
the corresponding field of the GACB is 
not affected. A comma must show the 
omission of the A, S, or R operand. 


PROGRAMMING NOTES: The values specified 
for the COMAREFA, DCB, ATTINTYP, and EP 


operands of the SAEC macro instruction are 
inserted in the first, second, fourth, and 
fifth words of the GACB, respectively. Ali 
should be defined before a SPAR macro 


instruction referring to this GACB is 
issued. 
The GACB, created by the SAEC macro 


instruction, is 14 words long. The first 5 
words of the GACB have the following for- 


mat: 
Coe Se Si ee 1 
GACB +0] COMAREA address | 
|-------—--__-------------—- { 
+4] DCB address | 
}-----~--------------~--------- : 
+8] Reserved | 
SA a eR a a 4 
+12| ATTNTYP address | 
| ------------------------------ { 
+16] EP address | 
Vn ne ar IS NEC es ale er ee J 


EP field of the GACB 
equal to zero, the programmer may queue 
attention data and process it in a back- 
ground routine (as opposed to an attention 
handling routine). All attention data for 
GACBs with zero EP fields is placed on the 
same queue. The attention data may be 
accessed when desired by means of the 
ATTNINQ macro instruction. 


By setting the 


The EP field may be set to zero at 
assembly time (by means of the SAEC macro 
instruction) or at any time during execu- 
tion. If it is set to zero at execution 
time, any attentions received prior to 
setting EP equal to zero will be processed 
as described under "Background Infor- 
mation"; any received after EP has been set 
to zero will be queued. 


The first four words of the COMAREA have 
the following format: 
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ee oe We ay vas Se eas ee 7 

COMAREA +0| IX | RESERVED | TYPE | 
fk Se SS a | Care et die oe ee 4 

+4] RESERVED | 

se in a i i ce Ss a se a as | 

+8] RESERVED | 

es Si a a ec dei ws beh Sa Sas oo eae a { 

+12] RESERVED | 

t Sc a Ss i se a a me 


| USER DEFINED AREA | 
Field Contents 


These fields are 
control program. 


RESERVED used by the 


Ix If multiple 2260s are assigned to 
a Single DCB, this byte is set to 
an integer from 1 through 25 to 
indicate which device originated 
the attention that the routine 
has currently available for pro- 
cessing. The value of IX corres- 
ponds to the position of the 
device in the device list sup- 
plied by the DD card and placed 
in the DEB by an OPEN macro 
instruction. (IX functions in 
the same manner as the “unit" 
operand of the GREAD, GWRITE, and 
GCNTRL macro instructions.) If 
one 2260 is assigned to a single 
DCB, the byte is set to zero 
(hexadecimal 00). 


This is always a hexadecimal 07, 
Signifying a 2260 attention. 


TYPE 


The user may add other fields to the 
COMAREA; see the suggestion under "User's 
Attention Handling Routine," beiow. 


If an attention routine is to serve more 
than one device, and these devices have 
been specified in separate SAEC macro 
instructions, its executable code must be 
reenterable. 


The DCB address in a GACB should not be 
changed without first deleting the atten- 
tion routine with a DAR macro instruction. 
After changing the DCB address, the routine 
must be respecified with a SPAR macro 
instruction. 


EXAMPLES: 


GACBX1 SAEC EP=AR1,DCB=GRAPHD1, 
ATTNTYP=2260, 
COMAREA=AREA1 


The GACB established by this macro 
instruction can be referred to by the 
symbol GACBX1. The GACB defines an atten- 
tion routine whose entry point is ARI. 
This routine is able to service attentions 


from the 2260 display station or stations 
associated with the identified DCB, and 
Will receive attention information in the 


COMAREA identified by the symbol AREA1. 
Because the macro-form (MF) is not speci- 
fied, i-form is assumed. 


EX2 SAEC DCB=GRPHDCB2,EP=(3), 
MF=(E, GACBX1) 


This macro instruction changes the DCB 
address and the attention routine entry 


point in the GACB defined in the first 
example. 

Note: If this routine has been previously 
specified (with a SPAR macro instruction) 
it must be deleted (with a DAR macro 
instruction) before changing the DCB 
address. After issuing the SAEC macro 


instruction to change the DCB address, the 
attention routine must then be respecified 
before it is available to the system. 


SPAR--Specify Attention Routine Macro 
Instruction 


The SPAR macro instruction makes pre- 
viously defined attention handling routines 
available for system use by establishing 
control program references to their GACBs. 
It also assigns priority if multiple atten- 
tion routines are defined. The format of 
the SPAR macro instruction is: 


eae ea Se ae ee ee ee ee 
| Name | Operation|Operand | 
~-------}~---------}----------------------| 
| [symbol] | SPAR | (gacb address 

| | | (€,gacb address]...) | 
| (, PRTY=integer] | 
{[(,MF={L|(E,gacb list | 
| address) }] | 
L 


gacb address 


specifies the address of a graphic 
attention control block (GACB), de- 
fined by a SAEC macro instruction, 


which is to be made available to the 


system. 


PRTY= 

is a decimal integer from 0 through 
127, used to determine priority among 
attention routines. Priority in- 
creases with numeric vaiue (127 gives 
highest priority). No attention rou- 
tine may have control while a_ higher- 
priority routine for the same device 
has any processing to do. 


MF=L 
specifies the construction of a list 
of GACB addresses which can be used by 
an E-form of either a SPAR or DAR 
wracro instruction. 


PROGRAMMING NOTES: The 


ERROR CONDITIONS : 


MF=E 

specifies that the list of GACBs 
referred to by the "gacb list address" 
operand is to be nodified as indicated 
by the “gacb address" operands, and 
that the GACBs in the list are then to 
be specified, i.e., made available for 
system use. The list cannot be 
lengthened or shortened by the E-form 
of this macro instruction. 


gacb list address 
specifies the address of a list of 
GACBS established by an L-form SPAR 
macro instruction. 


PRTY operand is 
provided primarily for compatibility with 
certain other graphic devices, which are 
capable of originating more than one type 
of attention. For such devices, the PRTY 
operand permits a routine designed to han- 
dle attentions of a particular type to 
interrupt another, less important, atten- 
tion routine that handles attentions of 
another type from the same device. The 
programmer establishes the relative 
"importance" of routines for this purpose 
by use of the PRTY operand. This usage is 
not possible on the 2260, which can origi- 
nate only a single type of attention. 
Therefore, the PRTY operand can normally be 
omitted. 


When the PRTY operand is 
priority of 0 is assigned. 


omitted, a 


If more than one attention routine is 
available for any one 2260 at any time, and 
if these routines have been assigned the 
same numeric priority (as, for example, by 
omission of the PRTY operand), the routine 
referred to last in the last SPAR macro 
instruction has the highest priority. 

All attention handling routines take 
precedence over any background routine. 


An attention routine may be interrupted 
and immediately reentered if the same rou- 
tine is defined in separate SPAR macro 
instructions for two or more display sta- 
tions or if the routine is used by more 
than one task. Such a routine must be 
reenterable (it must not modify itself in 
any way). 


If the same GACB is referred to more 
than once in a SPAR macro instruction, 
references after the first are treated as 


no-operations. A GACB address of 0, in a 
list of GACB addresses, will also be treat- 
ed as a no-operation. 


Certain error conditions 
will stop the processing of a list of GACBs 
and cause an immediate return. Upon return 
to the program, register 1 will contain the 
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address of the GACB associated with the 
error condition, and register 15 will con- 
tain one of the following return codes to 
indicate the type of error: 


Return Code Error Condition 


04 GACB contains address of 


invalid DCB 


08 GACB already specified by a 
previous SPAR macro instruc- 
tion 

0c Request for main storage need- 
ed for control program refer- 
ences was not satisfied 

14 (MVT only) SPAR macro instruc- 


tion issued by a task other 
than the one that opened the 
DCB, or one of its subtasks 


EXAMPLES : 
EX1 SPAR (GACBX2) 
This macro instruction establishes con- 


trol references to the routine defined in a 
GACB identified by GACBX2. 
EX2 SPAR (GACBX1,NAME3,TAG6) ,MF=L 

This macro instruction constructs a list 
containing the three GACB addresses speci- 
fied. 

EX3 SPAR (,,GACBX3),MF=(E, EX2) 

This macro instruction causes the param- 
eter list constructed by EX2 to be modi- 
fied, replacing the third GACB_ address 
(TAG6) with GACBX3. Control references are 


then established for the three GACBS 
referred to by the list. 


DAR--Delete Attention Routine Macro 
Instruction 


The DAR macro instruction is the inverse 
of the SPAR macro instruction. It makes 
attention handling routines unavailable for 
system use by deleting the control program 


references to the GACBs established by 
SPAR. The format of the DAR macro instruc- 
tion is: 

fe ee to 1 
| Nam | Operation |Operand | 
ne a, eS | 
| [symbo1]| DAR | (gacb address | 
| | | (,gacb address]...) | 
| | | (,MF={L|(E, gacb list | 
| | | address) }] | 
Ma A a ie td 


gacb address 
specifies the address of a GACB defin- 


26 


Return Code 


ing the attention routine to be delet- 


ed. 

MF=L . 
specifies formation of a list of the 
GACB addresses written in the macro 
instruction. 

MF= 
specifies that the list of GACBs 


referred to by the “"gacb list address" 
operand is to be modified by the "gacb 
address" operands, and that all atten- 
tion routines referred to in the list 
are then to be deleted, i.e., made 
unavailable for system use. 


gacb list address 
specifies the address of a list of 
GACB addresses constructed by an L- 
form SPAR or DAR macro instruction. 


PROGRAMMING NOTES: The CLOSE function will 
delete all attention routines defined for 
the associated DCB. However, an attempt to 
issue a CLOSE macro instruction from an 
attention routine will result in abnormal 
termination of the task. Similarly, an 
attempt to delete an active attention 
routine will result in an error condition. 


ERROR CONDITIONS: Certain error conditions 
will stop the processing of a list of GACBs 
(or of one GACB) and cause an immediate 
return. Upon return to the program, reg- 
ister 1 will contain the address of the 
GACB associated with the error condition, 
and register 15 will contain a return code 
to identify the error condition as follows: 


Error Condition 


O4 GACB contains address of 


invalid DCB 


08 Routine not found (not speci- 
fied by a SPAR macro 
instruction) 

oc Routine active 

14 (MVT only) DAR macro instruc- 
tion issued by a task other 


than the one that issued the 


SPAR for this GACB 


ATTNINQ--Attention Inquiry Macro 


Instruction 
The ATTNING macro instruction estab- 
lishes communication between an attention 


handling routine and the control program to 
permit the selection of an attention froma 
particular display station from among all 
attentions on a queue, or entry into a wait 
state or temporary relinquishment of con- 
trol pending a desired attention, or clear- 


ing of a queue. The format of the ATTNINOQ 
macro instruction is: 


sss NS a ee 1 
{Operation |Operand | 


fe 
|symbol{ATTNINQ |gacb address, 
| 


|MODE={R|W| (c, branch address) |CLEAR} | 
| (, UNIT={integer |ALL}] | 
bosses Spee ere an ea BESS it sa Sk SE a 4 


gacb address 
specifies the address of the associat- 
ed GACB. 


MODE= 
specifies one of the 
inquiry, as follows: 


four modes of 


relinquish mode. The attention rou- 
tine is to relinquish control until 
attention information from any display 
station the routine is servicing is 
available for that routine. When this 
information is available, processing 
continues with the next sequential 
instruction. This mode is treated by 
the system as a W (wait) mode if the 
ATTNINQ macro instruction is issued 
from a routine entered by means of a 
LINK macro instruction or if the EP 
field of an associated GACB has been 
set to zero. 


wait mode. The task is to be placed 
in a wait state pending availability 
to it of attention information from 
the display station specified by the 
UNIT operand. This wait state does 
not prevent interruption by a routine 
that has been inactive, but prevents 
control from returning to an inter- 
rupted routine or one that has been in 
a wait state. When the wait condition 
is satisfied, processing continues 
with the next sequential instruction. 


C, branch address 
condition mode. If attention informa- 
tion from the device specified by the 
UNIT operand is presently queued for 
this routine, a branch is taken to the 
location specified by the “branch 
address" operand; otherwise, process-— 
ing continues with the next sequential 


instruction. 

CLEAR 
clear mode. All attentions queued for 
this routine are to be released. 
Processing continues with the next 


sequential instruction. 


UNIT 
is a decimal integer from 1 through 
25, and corresponds to the position of 


the device in the device list supplied 


by a DD statement, where multiple 
devices are assigned to a single DCB. 
It is used as an index to select one 


of the several UCB addresses appended 
to the data extent block (DEB). The 
index value corresponding to the 1053 
printer may not be specified. (This 
operand functions in the same manner 
as the “unit" operand of the GREAD and 
GWRITE macro instructions.) 


ALL 
specifies that an attention will be 
accepted from any 2260 assigned to the 
DCB. 


If the UNIT operand is omitted, ALL 
is assumed. 


PROGRAMMING NOTES: The ATTNINQ macro 
instruction may be issued from within the 
scope of an attention routine or if the EP 
field of the associated GACB is set to 


zero, May be issued from a background 
routine. Standard register conventions 
must be observed (see the IBM System/360 


Operating System; Supervisor and Data _  Man- 
agement Services publication). 


The UNIT operand must be used in con- 
junction with the W or C mode if there are 


multiple devices for the associated DCB. 
It is meaningless in conjunction with the 
CLEAR or R mode. 

Under R, W, or cC mode, information 
pertaining to the attention that satisfies 
the inguiry is made available in the 
COMAREA. 

EXAMPLES: 


EX1 ATTNINQ GACBX4, MODE=R 


This macro instruction causes control by 
the attention routine to be relinquished 
until the desired attention occurs. 


EX2 ATTNINQ GACBX4, MODE=W,UNIT=5 


This macro instruction causes the task 
to enter a WAIT state until attention 
information from the display station which 
occupies the fifth position on the device 
list is available. 


EX3 ATTNINQ GACBX4, MODE=(C,BRANCHA), 


UNIT=5 
This macro instruction causes a branch 
to be taken to location BRANCHA if an 


attention from the display station which 
occupies the fifth position on the devices 
list is already on a queue. 
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EX4 ATTNINQ GACBX4,MODE=CLEAR 


This macro instruction causes all atten- 
tions on the queue to be released. 


USER'S ATTENTION HANDLING ROUTINE 


The following notes may be helpful to a 
user writing a program designed for 
operator-machine communication. 


ESTABLISHING THE ATTENTION ROUTINE 


An attention routine is defined by means 
of a SAEC macro instruction, which estab- 
lishes a graphic attention control block 
(GACB) containing the information provided 
in the SAEC macro instruction. In the GACB 
are: 


1. The address of the entry point of the 
associated attention routine. 


2. The address of a DCB associated with 
the device to be serviced. 


3. The address of a communication area 
(COMAREA) to be used to pass attention 
information to the attention routine. 


The GACB thus provides a link between a 
display station, or group of display sta- 
tions, and an attention routine. 


Although defined, an attention routine 
is not available for use until it has been 
"specified" by means of a SPAR macro 
instruction. This establishes control pro- 
gram references to it. 


The DAR macro instruction can be used to 
disable an attention routine which is no 
longer desired active although the asso- 
ciated DCB remains open. The SPAR and DAR 
macro instructions may be thought of as 
analogous to OPEN and CLOSE. 


PROCESSING THE ATTENTION 


attention routine, 
the address of the 


Upon entry to an 
register 1 contains 


GACB. In the first word of the GACB is the 
address of the communication area, or 
COMAREA. If more than one device is 


assigned to the DCB, the first byte of the 
COMAREA indicates the device that originat- 
ed the attention. 


Use of the communication area allows the 
programmer to pass information between the 


housekeeping/background routine and the 
attention routine(s). Each display station 
may be associated with its own communi- 


cation area, and the attention data for 
each display station may be recorded inde- 
pendently of that for other display units. 
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One of the fields in the communication area 
can be an ECB where completion of attention 
processing can be posted. The attention 
routine can post the appropriate ECB when 
it completes attention processing for that 
display station. 


Using the information available in the 
COMAREA and the DCB, the attention routine 
can perform necessary calculations, issue 
appropriate input/output commands, and do 
whatever else is required to respond to the 
attention. If further communication from 
the display station operator is required, 
an ATTNINQ macro instruction can be used to 
relinquish control or enter a wait state 
until the desired attention occurs, or to 
set up a conditional branch based on its 
availability. 


When processing of the last attention of 
a communication sequence has been complet- 
ed, the queue (for this routine) can be 
cleared by means of an ATTNING, mode CLEAR, 
macro instruction before passing control to 
the interrupted routine by means of the 
RETURN macro instruction. 


Following is a brief outline of func- 
tions that might be performed by a 
housekeeping/background routine and by an 
attention handling routine. 


Housekeeping/Background Routine 


1. Open the DCB for the display station 
or stations. 


2. Establish the 
means of the 
instructions. 


attention routine by 
SAEC and SPAR macro 


3. Issue input/output commands. 


4. Wait for posting of completion in the 
event control block (ECB) or perform 
background processing, which may or 
may not be related to the attention 
routine. 


5. Close the DCB. 


6. Indicate task completion by 
the RETURN macro instruction. 


issuing 


Attention Routine 


1. Perform standard entry functions: save 
registers, establish addressability, 
etc. 


2. Perform operations based on the atten- 
tion information. 


3. Issue input/output commands. 


4. Wait for the next attention by means 
of the ATTNINQ macro instruction. 


5. After the last attention is serviced, 
post completion in the ECB and return 
control to the background routine by 


reans of the POST and RETURN system 
macro instructions. 
SYNCHRONIZING THE USER'S ROUTINES 
Synchronization of the housekeeping/ 
background routine and the attention rou- 
tine is the programmer‘s responsibility. 


He may use the WAIT system macro instruc- 
tion to delay execution of the 
housekeeping/background routine until com- 
pletion has been posted in an ECB by the 
user's attention routine. The attention 
routine may either explicitly post the ECB 
by means of the POST system macro instruc- 
tion or, by means of a user convention, 
locate the appropriate ECB via the graphic 
attention control block and then post com- 
pletion. The attention routine passes con- 
trol back to the housekeeping/background 


routine by means of the RETURN macro 
instruction. Since completion has_ been 
posted, the housekeeping routine is taken 


out of its wait state and execution contin- 


ues. This cycle, the passing of control to 
the attention routine when an attention 
occurs and tne returning of control to the 


interrupted (housekeeping/background) rou- 
tine when completion is posted, continues 
as long as the attention routine is defined 
and as long as attentions occur. 


MVT CONSIDERATIONS 


The following rules apply to the use of 
basic attention handling facilities in an 
MVT environment. 


e In order for the user's attention han- 
dling routines to be available toa 
device, they must be defined (via a 
SAEC macro instruction) and specified 
(by a SPAR macro instruction) within 
the task that opens that device, or 
Within one of its  subtasks. A SPAR 
macro instruction issued from an inap- 
propriate task will return with a 
return code of hexadecimal 14. 


e Each GACB must be deleted (by DAR) by 
the task in which it was specified 
(SPAR). A DAR macro instruction from 
another task will cause a return with a 
return code of hexadecimal 14. An 
attempt by one task to close a DCB for 


which one or more GACBs are still 
specified by another task will result 
in the abnormal termination of the 


specifying task. 


e An ATTNINQ macro instruction for any 
GACB may be issued only by the task 
that specified (SPAR) that GACB; other- 
wise, the task issuing the ATTNINQ 
macro instruction wiil be abnormally 
terminated. 


e A user's attention routine may serve 
more than one task. However, a sepa- 


rate GACB must be established for each. 
task-device-routine combination. The 
user is responsible for insuring that 


the task containing the attention rou- 
tine is not terminated while other 
tasks have active (currently specified) 
GACBs referring to that routine. 
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APPENDIX A: SAMPLE PROGRAM 


Coding shown in Figure 1 is intended for 
use with two IBM 2260 Display Stations 
(Local Attachment), equipped with the 
alphameric keyboard feature. A 1053 Print- 
er is not needed. 


For the purpose of this sample program, 
it is assumed that the first seven charac- 
ters of the manual input message contain a 
code which determines whether the routine 
processes the message and stores’ the 
results, or ends the job 
results derived from the processing of each 
individual request. 


The purpose of each element of the 
program is explained by the comments in the 


illustration. The following paragraphs 
point up applicable graphic programming 
considerations. 


Opening the DCB: The DCB for the 2260s must 
be opened before references are made to it. 


IBM 
nocun 2260 SAMPLE PROBLEM 


and displays 


PROGRAMMER P DATE 


STATEMENT 


Use of the GREAD Macro Instruction: The 
GREAD macro instruction shown in the coding 
generates a Read Display Station Manual 
Input (DSM) operation. 


Use of the GWRITE Macro Instruction: The 
GWRITE macro instruction shown issues an 
Erase and Write Display Station Buffer 
Storage (EBW) operation to clear the stor- 
age and write a message to the operator. 


Use of the Basic Attention Handling Facili- 


ties: All user-defined attention routines 
should consider themselves as subroutines, 
and as such, standard subroutine linkage 
should be observed. The COMAREA should be 
saved if there is any possibility that the 
attention routine presently in control may 
be interrupted during execution by another 
attention routine which shares the same 
COMAREA. 
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Figure 1. Coding for Sample Program (Sheet 4 of 6) 
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APPENDIX B: CCW*S ASSOCIATED WITH INPUT/OUTPUT CONTROL 


The following are formats of CCWs generated when GREAD, GWRITE, and GCNTRL macro 
instructions are used. 
GREAD DSM CCW FORMAT 
Command Data Byte 
Code Address Flags* Count 
Se ered 
{| oO2 | cr | — FE dot | | 
be ee St eS ee eee 
0 7 8 31 32 33 34 35 36 48 63 
GREAD DSMW CCW FORMAT 
Command Data Byte 
Code Address Flags+* Count 
Ca se a ee ee ee eae a aR a 1 
{ 12 | tr | t | to | | 
bee he S LCSRpsarre: ase! LON! ESSE LeRIVSPINO! Sore Raneelteanyes sone apne SS Se eats eae! 4 
0 7 8 31 32 33 34 35 36 48 63 
GREAD SMI CCW FORMAT 
Command Data Byte 
Code Address Flags* Count 
Fr a ee a ee a oe a ee eee 
| OA | ee er) ee ee | | | 
a a a ee eed 
0 7 8 31 32 33 34 35 36 48 63 
GREAD SMIW CCW FORMAT 
Command Data Byte 
Code Address Flags* Count 
alah ncaa yaaa We Oe Oe a ee ee ee aa aaa 1 
| 1A | fr — | det ot | | 
Gear meee Ue so te re ed 
0 7 8 31 32 33 34 35 36 48 63 
GREAD DSB CCW FORMAT 
Command Data Byte 
Code Address Flags* Count 
Part oe re ToS ee ee, Boe a en 1 
| 06 | Pr [2 ¢t ¢ | 02 | 
a a dee ea ee J 
0 7 8 31 32 33 34 35 36 48 63 
Command Data Byte 
Code Address Flags* Count 
=, oe oe zs Naa Neen ToT ee eae ahaa apa aca aad 1 
| O7 | fr | Ett t 1 | 02 | 
[SR eee eaele te SEE en eR ENE dese lens peas mR SIN MARR EE ay NE ee eas een, Mh a et es 4 
0 7 8 31 32 33 34 35 36 48 63 
* 
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Bit 33 -- chain command flag 
Bit 34 -- suppress length indication flag 


GREAD DSBW CCW FORMAT 


Command Data Byte 
Code Address Flags* : Count 
SR ee Te ST en 1 
; 16 | | ji | | | | | | 
ayaa eee pean eee Seen) Commas i See eaes Deane eel eeent| Arann rene ee ke ON ER EE ety] Roe aepenennn tee eee Urennr agen Sarat J 
0 7 8 31 32 33 34 35 36 4g 63 
Command Data Byte 
Code Address Flags* Count 
Poe ee fe ee De pee ee eee 1 
| 17 | 1 | ytt 4 | | | 
Loeczo. Herre ele aera ae een mC Mees ee WS pete ees J 
0 7 8 31 32 33 34 35 36 48 63 


GWRITE DSB CCW FORMAT 


Conmmand Data Byte 

Code Address Flags* Count 
Co Toes Se foeei ss fe Shae ee Se eer ene ee 1 
| o1 | bP tft [tt J | | 
iene i aoe enema ees Water A a a a hee eee J 
0 7 8 31° 32 33 38 35. .36 48 63 


GWRITE DSBW CCW FORMAT 


Command Data Byte 

Code Address _ Flags* Count 
Pe ee a eR ee ae a Ae ee a ye ee er 1 
{ 411 | | | } i | i | | | 
a sd 
0 7 8 31 32 33 34 35 = 36 48 63 


GWRITE EBW CCW FORMATS 


command Data Byte 

Code Address Flags* Count 
cso Oe a ee pe ee ee ae ee ee ee ea 1 
| o7 | ,i] 1] | | | 02 | 
bee Aes Be i oes aa A NN coco Bt at ee deat Siete ates J 
0 7 8 31 32 33 34 35 36 48 63 
Command Data | Byte 

Code Address Flags* . Count 
(SS oe Poe oe ee ee aaa ac clade aa 1 
{ o1 | | | |} 1 | | | | | 
eens E Soe nace teee Reese ae te cai Ape ae Recs A aaa as te Mes eta ae et 4 
0 7 8 sk: 32. 33. 3A. .35-. 36 48 63 

GWRITE EBWW CCW FORMATS 

Command Data Byte 

Code Address Flags* Count 
Gate er eh re TS pe a re a eee 
{ 17 | f 2 |Ytt | | 02 | 
[ saeeeeen eres 2 ene re ee ee iN aN I a ee fin SS eee 4 
0 7 8 31 32 33 34 35 36 48 63 
Command Data Byte 

Code Address Flags* Count 
ne re eR rn et gga ate Pe ee eS a ee Bn ee ee 1 
f 411 | | I Jit | | | | 
[ Cae aeRO Y Nase ae eA AER CORON DER ASNEN LEC RE a VEMDORON Unrate? RMN i ies se Sunoco eos aneer ts a J 
0 7 8 31 32 33 34 #35 36 48 63 

* 


Bit 33 -- chain command flag 
Bit 34 -- suppress length indication flag 
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GWRITE LNE CCW FORMAT 
Command Data Byte 
code Address Flags* Count 


FT ee er ene ee ee ee eng ee eS ae grim ey CeRG aot Gets Tope] beard 


[| o5 | Po Fr =Ett t | | | 


bow LL LL LL dL 1d 


0 7 8 31 32 33 34 35 36 48 63 
GWRITE LNEW CCW FORMAT 


Command Data Byte 
Code Address Flags* Count 


PS we ee ee ee ee ee GMO eae ny ee ae a ee ae ea ee gy cd 


[| 15 | Pot Pratt ft | | | 
aL 


Be re he ee be 4... -L_..... L__ L$ Lb ed 


0 7 8 31 32 33 34 35 36 48 63 


GWRITE EWL CCW FORMATS 


Command Data Byte 
Code Address Flags+* Count 
Cr ee a ee ee ne ee 
{| o7 | | ;r {ii | | _ | 02 | 
a a te a eee 
0 7 8 31 32 33 34 35 36 48 63 
Command Data Byte 
Code Address Flags* Count 
Pe te ee es ie ee ee a gee 1 
| O05 | | | {1 | I | | | 
be th ee keke BR tas Ser Sen en) cae 4 
0 7 8 31 32 33 34 35 36 4g 63 
GWRITE EWLW CCW FORMATS 
Command Data - Byte 
Code Address Flags* count 
Same a ee esata pipe ee ee ee ge ee ee ee a 
| 17 | 1 i grt FF 4 | 02 | 
bs 55— i epee nete eee emer cM a Na IS ae Be Se ea J 
0 7 8 31 32 33 34 35 36 48 63 
Command Data Byte 
Code Address Flags* Count 
ao CS ee ee ee a ae oe fo se ee ee ee 1 
{15 | | f jJait | | | | 
bee eee ee keel ee eae od ee ee Pee ie ene a cee rns J 
0 7 8 31 32 33 34 #35 36 4g 63 


GCNTRL ERS CCW FORMAT 


Command Data Byte 

Code Address Flags* Count 
fae oc lo nr ee Eo one 1 
} O7 | bt | $!2t 7 ft | 02 | 
a a ee eed 
0 7 8 31 32 33 34 35 36 48 63 


GCNTRL ERSW CCW FORMAT 


Command Data Byte 
Code Address Flags* ; Count 


CPS a ee ee ee te ee ee my ee a et a 


{| 17 | ; ft ~2t ft 1 | 02 | 


Bn he ee ee ee ee he Le Le LL Le ee en he eed 


0 7 8 . 31 32 33 34 #35 36 48 63 


* 


Bit 33 -- chain command flag 
Bit 34 -- suppress length indication flag 


The operator at the 2260 Display Station 
can communicate information to the system 
through use of a keyboard. Keyboard input 
results in an attention interruption. 
Express attention handling requires that 
the user's problem program check for the 
occurrence of an attention. When an atten- 
tion is detected, attention information is 
automatically routed to the appropriate 
user-written attention handling routine. 


Macro instructions are provided to com- 
municate the occurrence of attentions to 
the problem program. The macro instruc- 
tions and their functions are listed in 
Table 8. 


BACKGROUND INFORMATION 


When an attention from a 2260 occurs, 
the problem program is interrupted and 
control goes to the control program. The 
control program sets a bit in the graphic 
control byte (GCB) associated with the 
display unit from which the attention was 
received. Control then returns to the 
problem program at the point of interrup- 
tion. 


To determine whether or not an attention 
has occurred, the user's problem program 
must include an attention analysis provi- 
sion for periodically inspecting the bits 
in the GCBs. This attention analysis can 
be done by using either the ANALYZ macro 
instruction or a user-written substitute. 
If the user elects to perform his own 
attention analysis, he must employ the 
GSERV macro instruction to reset bits in 
the GCBs. 


Table 8. 


- 
Mnemonic|Macro Instruction Name 


| ANALYZ 
| 


| 
| 
| 
L 


APPENDIX C: EXPRESS ATTENTION HANDLING 


EXPRESS ATTENTION HANDLING MACRO 
INSTRUCTIONS 


The macro instructions in this group are 
provided to help the user service atten- 
tions from the 2260. 


ANALYZ--Graphic Attention Analysis Macro 
Instruction 


The ANALYZ macro instruction performs an 
attention analysis function to determine 
the occurrence of and the reason for an 
attention from a keyboard entry on the 
2260. This is done by a polling technique 
which inspects the bits in the GCBs. The 
ANALYZ macro instruction also resets the 
GCB (by calling on the GSERV macro 
instruction), places coded information into 
an output area defined by the user, and 
gives control to the appropriate user- 
written routine to handle the attention. 


To employ the ANALYZ macro instruction, 
the user must: 


1. Include the. ANALYZ macro instruction 

statement in his problem program. 
2. Provide a contiguous list of DCB 
addresses and UCB index factors that 
indicate the UCB containing the — 
appropriate GCB from which an atten- 
tion is possible. This list is pro- 
vided at open time if the POLST 
operand is specified in the DCB macro 
instruction. 


3. Specify the entry address of the rou- 
tine to handle the keyboard attention. 


Express Attention Handling Macro Instructions 


| Mnem Spee GM hte) ee ee eee ee ee ee ee ee ea Oe No aga Pee Ion Dp © INA TE Oe bey Ie 1 


Function 


Determines and analyzes the occurrence 
of an attention from a display station. 
The bits in the GCB are reset before 
control is given to ae_euser-written 
routine to handle the attention. 


Resets the bits in the GCBs associated 
with attentions. This macro instruc- 
tion must be employed if a user elects 
to perform his own attention analysis 
instead of using ANALYZ. 


oc ce er wc rn ee eee ee ee ee were eee eee cnc a ee ee me ee a ee earner es em me a lve came near ee oe wc ae ee ee rn a a ae rc a 
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4&. Reserve eight bytes (beginning at a 
full-word boundary) in his 
area, into which the output of ANALYZ 
can be placed. 

The format of the ANALYZ macro instruction 
is: 


rer ee ee 1 
| Name | Operation] operand | 


ak a einen an Ss i naan | 

| [symbol] | ANALYZ |polst address, | 
| 1 jpointer address | 
| | | (,MF={L|(E,parameter | 
| | {| list name) |(E, (n))}] | 
L 


eS eR Ce ED | 


polst address 

is the address of a 4-byte reserved 
area followed by a list of DCB 
addresses and UCB index factors that 
indicate the UCB containing the 
appropriate GCB. Each is aligned on a 
full-word boundary. The reserved area 
is used by ANALYZ to point to the last 
DCB address in the list. The list is 
constructed at open time if the POLST 
operand is specified in the DCB macro 
instruction. The format of the list 
is: 


es! | aaa aa aie eee | 
jucB | DCB | 
{Index | Address | 
-—---- }-------—-----------—- 
jUCB | DCB | 
{Index | Address | 
}------4-------—-------------] 


pointer address 
is the symbolic address of the first 
word of a 5-word field located on a 
full-word boundary in the user's pro- 
gram area. The contents of the field 
are shown in Table 9. 


Table 9. Contents of the Pointer Table 


ae te iene bo ee Ge ge POs ghar ee ah 


|Word | Contents | 


t + 

| 1 |(Not used. Programmer must specify| 
| | zeros.) 

| 2 {Address of the user-written Keyboard| 
| |Attention routine. | 
| 3 |(Not used. Programmer must specify| 
| | zeros.) | 
| 4 |{(Not used. Programmer must specify | 
| | zeros. ) | 
| 5 |Address of the first byte in the| 
| doRepee area (see "Output" below). | 
L 


Note: The user must insert zeros in three 
of the five words indicated in Table 9. 
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program 


Word 2 of the Pointer Table must contain a 
valid routine address if either optional 
keyboard feature is used. 


MF=L 

specifies that expansion of the macro 
instruction is to consist of a param- 
eter list only. The name of the 
parameter list is the symbolic name 
specified in the "Name" field of this 
ANALYZ macro instruction. The "polst" 
and "pointer" operands may only be 
written as relocatable expressions. 


MF=(E, parameter list name) 
specifies the macro instruction is to 
perform the ANALYZ functions using a 


parameter list constructed by another 
ANALYZ macro instruction. The 
"parameter list name" operand must 


correspond exactly to the name of the 
parameter list. 


MF=(E, (n)) 

performs the same function as 
(E, parameter list name). By writing 
register notation (in the range 2 
through 12), the programmer signifies 
that he will load the address of the 
parameter list into the indicated reg- 
ister before the macro instruction is 
executed. 


OPERAND FORM: The following are the allowa- 


ble operand forms for the ANALYZ macro 


instruction. 


1. If the MF keyword operand is omitted 
or specified as L, the "polst address" 
and "pointer address" operands must be 
written as relocatable expressions. 


2. If the MF=E keyword operand is speci- 
fied, the “polst address" "pointer 
address", and “parameter i1ist name" 
operands can be written as relocatable 
expressions; as implied or explicit, 
indexed or nonindexed addresses; or in 
register notation. For example: 


LISTNAME. ANALYZ POLST, POINTER, MF=L 


ANAYLZ .POLST1,MF=(E, LISTNAME) 
or 

LA 2, POLST1 

LA 3, LISTNAME 

ANALYZ (2) ,MF=(E, (3)) 


ERROR CONDITIONS: If 
address" or "pointer address" operand is 
missing at assembly time, a message is 
printed on the assembly listing indicating 
the omission, and macro generation contin- 
ues. If either parameter is missing, the 
macro instruction does not perform its 
intended function. 


either the "“polst 


OUTPUT: The output of the ANALYZ macro 
instruction is placed in an 8-byte output 
area whose address is in word 5 of the 
Pointer Table. This area must begin at a 
full-word boundary. Output consists of the 
following, in the order listed: 


e Reserved (four bytes) 
e UCB address index factor (one byte) 
e Address of DCB (three bytes) 


ROUTINE EXITS: If inspection of the DCB 
list finds no attention indication, a code 
of hexadecimal 04 is placed in the return 
code register, and control is returned to 
the next sequential instruction in the 
user's program. If an attention is detect- 
ed, the macro instruction determines the 
address of the DCB, resets the GCB, stores 
output data in the output area, and gives 
control to the appropriate user-written 
attention handling routine with the address 


of the output area in register i and the 
return address in register 14. The user 
must save and restore registers in his 


attention handling routine. 


Note that the user-written attention 
handling routine, upon completion, does not 
return control . to ANALYZ. Control may he 
returned from the user-written attention 
handling routine to the next sequential 
instruction after ANALYZ by use of the 
RETURN macro instruction. 


When ANALYZ is executed, it starts ini- 
tially at the top of the poll list; but 
after the initial keyboard attention has 
been processed, starts at the point of 
previous exit from the poll list. 


A return to the user's next sequential 
instruction is made (1) if no attention 
occurred, or (2) if the address of a 2260 
keyboard attention routine is not provided 
in word 3 of the Pointer Table, or (3) if 
the address of an output area is not 
provided in word 5 of the Pointer Table. 
The attention is lost if no keyboard atten- 
tion routine is provided. The return code 
register contains a hexadecimal code to 
indicate the reason for this return, as 
follows: 


Contents of 
Return Code 


Register Meaning 

00 Normal 

04 No attention occurred 

08 Attention occurred but no 
attention handling routine 
provided 

oc Either no *"polst address" 
specified or no “pointer 
address" specified , 

10 No output area provided 


‘might logically be expected from a 


EXAMPLE: Figure 2 illustrates applicable 
coding ina typical IBM 2260 Local graphic 
job that uses the ANALYZ macro instruction. 


POLST is the symbolic address of the 
first full-word entry in a list of DCB 
addresses and UCB index factors. Note that 


the first word in the list is set to zeros. 
POINTER is the symbolic address of the 
first entry in a 5-word table that contains 
the entry address of the user-written 
attention handling routines and the address 
of an output area (OUTAREA). 


ee ee eee SO a RS ce DS OS ET SD NE SE AS SD SE ES TS A SE I ES A SE ce 


‘ 
|* MAIN ROUTINE PROCESSING 
| ; 
| 


: 
| 
| 

| | 

ANALYZ POLST,POINTER | 
| . | 
| . | 
| : | 
| POLST pc F'o' | 
| DS 2F | 
|POINTER DC F'Q' | 
| Dc A(KBRTN) | 
| DC 2F"0' | 
| pc A(OUTAREA) | 

JOUTAREA DC 2F'0° l 

J 


bow oe ee ee ae ee eee 


Graphic Attention Analysis Rou- 
tine, Coding Example 


Figure 2. 


SUGGESTIONS FOR THE USER: The user opens 
the graphic device, thereby setting up the 
appropriate control blocks. A suggested 
initialization procedure is the execution 
of a channel program, after the device is 
open, to inform an operator at the display 
station that the graphic program is now 
executing. Polling might then be started 
immediately by the problem ‘program if 
information resulting from attentions is to 
be processed. 


an attention 
display 
station, polling should be done periodicali- 
ly. The timing of this function may be 
handled either by employing the ANALYZ 
macro instruction at appropriate times dur- 
ing execution of the problem program, or by 
use of a Set Interval Timer (STIMER) system 
macro instruction which causes the 
System/360 interval timer to employ tne 
ANALYZ macro instruction at user-specified 


intervals. (See IBM System/360 Operating 


System; Supervisor and Data Management Ser- 
vices for the format and use of the STIMER 


macro instruction.) However, if the timer 
is used for establishing the interval 
between poll cycles, it is not available 
for establishing other task intervals. 


During the period that 


Appendix C 39 


Note: If the user wishes, he may wait for 
an attention by repeatedly executing the 
polling routine (that is, branching to the 
ANALYZ statement). It should be noted, 
however, that such a technique would defeat 
one of the primary purposes of a system 
having multiprogramming capabilities. 


The coding of Figure 3 shows how the 
System/360 interval timer can be used to 
establish a polling interval. After the 
DCB for the device has been opened, use of 
the STIMER macro instruction provides an 
automatic transfer to the polling routine 
after a user-specified interval of real 
time (0.2 seconds in Figure 3). Until the 
interval has elapsed, processing continues 
in the main routine. Action taken by the 
polling routine, ANALYZ, depends upon 
whether or not an attention occurred. Con- 
trol is passed to the user's attention 
handling routine if there was an attention 
or is returned to the instruction following 
the ANALYZ macro instruction if an atten- 
tion did not occur. 


CSF ee A ee ak ag a ee a CP Se pee 
OPEN DCB1 
STIMER REAL, POLADR, 
. DINTVL=TIME 


| 

| 

| 

| 

| 

| 

|* MAIN ROUTINE PROCESSING 
| 

| 

| ; 

| CLOSE 
| 

| 

| 

| 


DCB1 
DS OD 
| TIME pc Z*00000020" 


|POLADR ANALYZ POLST, POINTER 
|* IF NO ATTENTION, RETURN TO MAIN RIN 


| . 
| . 
| . 
lL. — ——. —— ~~ —— 


Implementation of Polling 


ACNE OLE A GE SRD CET A SA SE OL I EY NE eS UR GE OCR GUESS ON QR SEE SE oreo 


Figure 3. 


GSERV--Graphic Attention Service Macro 
Instruction 


The GSERV macro instruction resets GCBs 
associated with attentions so that an at- 
tention may not be handled more than once. 
This macro instruction is used by ANALYZ to 
reset the bits in the GCBs. If the user 
elects to perform his own attention analy- 
sis, GSERV must be used to reset (i.e., 
zero) bits in the GCBs. The format of the 
GSERV macro instruction is: 
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SERRE Sica ea a eo 
Operation|Operand | 
t =t 
| [symbol] |GSERV | {list item address, | 
gcb bit|(1)} | 


list item address 
is the symbolic address of a 4-byte 
field, aligned on a full-word bounda- 
ry, in the programmer's list of DCB 
addresses and UCB index factors. This 
list is constructed at open time if 
the POLST operand is written in the 
DCB macro instruction. The 4-byte 
field contains the address of the DCB 
and the UCB index factor that indi- 


cates the appropriate UCB for the 
device. 
ene eaacatest To -- 1. 
{UCB |DCB Address|ilist item 
| index | | address 
ee nae AS ee tas 4 
bit 0 7 8 31 
gcb bit 
specifies which bit in the GCB is to 


be reset. The value of "gcb bit" must 
be 1 for the 2260. 


If register notation is used, the param- 
eters must have been loaded into register 1 
before execution of the macro instruction. 
The format for loading the information into 
the register is as follows: 


aera | Lae AR 1 
|gcb bit|list item| register 1 
| | address | 


, See 


bit 0 7 8 31 


To define the bit to be reset, the 
programmer codes the high-order byte in the 
register as follows: 


Type of GCB Bit to 
Attention be’ Reset Code 
Keyboard Entry 7 Dc X‘'01' 


The address that comprises the three 
low-order bytes may be obtained from the 
poll list created by the OPEN macro 
instruction if the POLST operand was speci- 
fied in the DCB macro instruction. 


If the UCB address is invalid or if the 
device is not a graphic device, the job is 
abnormally terminated. 


After GSERV has reset the GCB bit, 
control is returned to the next sequential 
instruction of the calling program. 


PROGRAMMING NOTES: The graphic control byte 


is set to zero when the first DCB is opened 
for any display station. 


APPENDIX D: SUMMARY OF OPERANDS 


The Summary of Operands, shown in this appendix, contains all of 
the macro instructions and indicates the allowable ways of writing the 
operands. The summary is designed so that it can be opened with all 
the macro instructions displayed when the descriptions are being read. 
The classifications used in the summary are as follows: 


SYM 
is any symbol valid in the assembler language. 


DEC INT 
are any decimal digits up to the value indicated in the assoc- 
iated macro instruction description. If both SYM and DEC INT are 
checked, an absolute expression is also allowed. 


REGISTER 

is always coded within parentheses as follows: 

(2-12) - one of general registers 2 through 12, previously loaded 
with the right-adjusted value or address specified in 
the associated macro instruction description. The 
unused high-order bits must be set to zero. The register 
may be designated symbolically or with an absolute 
expression. 


(1) - general register 1, previously loaded as indicated above. 
The register can be designated only as (1). 


RX TYPE 
any address that is valid in a RX-type instruction (e.g., LA) may 
be designated. 


A-TYPE 

ADCON TYPE 
any address that may be written in an A-type address constant may 
be designated. 


Note: 


e Underscoring indicates a default option; that is, if no operand 
is coded, the underscored operand is assumed. 


e Braces,{ }, indicate that one operand from a vertical or 
horizontal group must be chosen unless a default option is 
indicated. 


e The vertical stroke (|) separates alternative operands within 
a horizontal group. 
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WRITTEN AS 


MACRO OPERANDS SYM DEC RX A-type 
INSTRUCTION INT (2-12) type | Adcon 
type 


ANALYZ | polst address refer to macro description 
pointer address refer to macro description 
“ L written as shown 
(E, written as shown 
parameter list name) 


pa ea 2 5 


ATINING [gach odress SS eee. Seb 
=/(R written as shown 
written as shown 
(C, written as shown 

branch oddress)) [J] x | __ TT 


CLEAR written as shown 
1 through 25 or ALL 
CLOSE | dcbaddress a t—“(id; CC xk 
MF=( L 
Ke 
parameter list name)$ [x J] «|x 
DAR | gacbaddress tC (TC“(CiEC SC KT 
| MF= ( L 
te | writtenasshown et sti—‘isSCid as shown 
gacb list address) [J ]_x |] x 
DCB 
PMAGRFS S~*SERT WIRE] WET AR, W) LARC WTR, WE)TIRC, WEDD 
EXPRESS } 


[DDNAMESidname x Or Or 
[ EXLST=exit list ockres | ——=«| i) dd 
TGNCP=number of blocks | ‘|_| *+| sd 
POLST=poll list address | | —+|| | +i i 


GCNTRL pdechname | x 
£ERS | ERSW } 
dcb address eee eae ine aN ae es a ee 
nn ee 
MES wg = EY oe a | 
GREAD -decbneme fe | | 
{DSM |DSMW| SMI |SMIW | DSB | DSBW 3 
dcb address meee (Oe ee Ss eee | ee, 
plength 
pareaaddress 
eat te 
oo es ES ee 
GSERV 
GWRITE | dechname 
[type ——<‘;S dL DSB DSBW I EBW I EBWW] OLNE [ LNEW | EWL] EWLW} 
deb address fe ee 
oe Oe A ae 


OPEN x x 
MF>( L 
a €, 
parameter list name) 


EP= entry point address 
0 


ea Ger eee ees ee eee, 
Ce ee ee ies eee ee 
Saar CSE Saas ISP ae etree Ciena eR 
DCB=dcb address aa cena (ei Sean (es) ae ee 
eee EE ee ee 


COMAREA=communication area 
address 


MF= 


MACRO OPERANDS SYM] DEC RK | Actype 
INSTRUCTION INT type Adcon 
type 

SPAR | gacbaddress CT CT x 
rece ve | DNR] (NEAINar SR] (ETS PCR NEY (PREONOes) Camm 

MF=( L written as shown 

te. written as shown 
gach list address) J [J 


Where more than one reference is given, 
the first page number indicates the major 
reference. 


alpharneric keyboard 5 
ANALYZ macro instruction 37-40,10 
ANALYZ pointer table 38 


attention 6,22,37 

attention handling, basic 22-29,6 
attention routine, user's 28,6 

attention type 24,25 

ATTNING macro instruction 26,27,23,24,28 
ATTNTYP 23,24 

kasic attention handling 22-29,6 


bit mask for resetting GCB 40 
buffer storage 5,14,15,16,17,18 


cathode ray tube 5 


cCWs (channel command words) 6,14 
CCW fcrmats 34-36 

channel byte count 13,14 

channel command words (CCWs) 6,14 


character generator 5 

check symbol 13,14 

CLOSE macro instruction 20, 21,8, 26 
COMAREA 23,24, 25,27,28,30 
completion flag in ECB 21 
conventions 6,7 

CRT (cathode ray tube) 5 

cursor 5,14,17,18,19 


DAR macro instruction 26,22,23 

data control block 
(DCB) 9-11,6,8,11,12,13,19,20, 30,37 
data entry 5 

data event control block 
(DECE) 9,12,13,14,15,16 

data extent block (DEB) 8 

DCB (data control block) 
9~11,6,8,11,12,13,19, 20,30, 37 

DCB macro instruction 9-11,8 

DD statement 8,10,11,12 

DDNAME 10 

DEB (data extent block) 8 

“‘DECB (data event control 
block) 9,12,13,14,15,16 

destructive cursor 14 

DSB (read full display station buffer 
storage) 14,12,34 

DSB (write buffer storage) 17,16,35 

DSBW (read full display station buffer 
storage without keyboard 
restcre) 14,12,35 

DSBW (write buffer storage without keyboard 
restcre) 17,16,35 

DSM (read display station manual input 
message) 13,12,34 

DSMW (read display station manual input 
message without keyboard 
restcre) 13,12,34 

DSORG 10,11 


INDEX 


EBW (erase and write display station buffer 
storage) 17,16,35 

EBWW (erase and write display station 
buffer storage without keyboard 

restore) 17,16,35 

ECB (event control block) 14,18,20,28,29 
E-form macro instructions 7,9 


end of message 13,14,15 
EP 23,24 
EP=0 24 


error handling 6 

errors, read 14,15 

errors, write 18 

ERS (erase display station buffer 

storage) 19,36 

ERSW (erase display station buffer storage 
without keyboard restore 20,19,36 

event control block (ECB) 14,18,20,28,29 
EWL (erase and write display station line 
address) 18,16, 36 

EWLW (erase and write display station line 
address without keyboard 

restore) 18,16,36 

EXLST 10 


Express attention handling 37-40,6 


format illustration conventions 6 


GACB (graphic attention control 
block) 22-28 

GCB 37,38,40 

GCNTRL macro instruction 19,20,8 

GNCP 10,11,12 

graphic attention control block 
(GACB) 22-28 

graphic attention service routine 

GREAD macro instruction 12-15,8 

GSERV macro instruction 40 

GTYPE 10 

GWRITE macro instruction 15-18,8 


40,37 


IBM 1053 printer 8,13,16,17 
IBM 1053 printer adapter unit 5 
IBM 2260 local 5 
IBM 2260 remote 5 
IBM 2701 data adapter unit 5 
IBM 2848 display control 5,8 
input/output block (IOB) 9,10,11 
input/output control 8-21,6 
input/output control routine 9 
input/output macro instructions 8 
CLOSE 20,21,8,26 
DCB 9-11,8 
GCNTRL 19,20,8 
GREAD 12-15,8 
GWRITE 15-18,8 
OPEN 11,12,8 
IOB (input/output block) 
IX 24 


9,10,11 


Index 43 


keyboard 5,22,37 


L-fornw macro instructions 7,9 

line addressing 5,17,18 

LNE (write display station line 

address) 17,15,37 

LNEW (write display station line address 
withcut keyboard restore) 18,16, 36 
linkage conventions 7 


MACRF codes 10 
macro-form operand (MF) 7 
MVT 29,21, 6 


new line symbol 13 
non-destructive cursor 5,14 
numeric keyboard 5 


OPEN racro instruction 11,12,8 
output of ANALYZ 39 


pointer table for attention handling 38 
rolling 39,40 

polling interval 39 

polling techniques 37,39,40 

POLST 10,38,39,40,10 

post the ECB 28,29 

POST wacro instruction 29 

printer adapter unit 5 

priority among attention routines 25,22 
PRTY 25 


HY. 


queuing of attentions 22,23 


read error 14,15 

register notation 7,15,18,20 
reset GCB 40 

RETURN macro instruction 23,28,29 


SAEC macro instruction 23,24,22,28 
sample program 30-33 

SMI (read display station short manual 
input message) 13,12,34 

SMIW (read display station short manual 
input message without keyboard 
restore) 14,12,34 

SPAR macro instruction 25,26,22,28 
Start symbol 13,14 

STIMER macro instruction 39,40 

stop sequence 14 

Synchronous error 6 

system generation 6 


terminology 7 


UCB (unit control block) 8,9 
UCB index 8,9 

unit control block (UCB) 8,9 
unit operand 9,12,13,16,18,27 


wait for an attention 29 
WAIT macro instruction 9,29 
wait state 26 

write error 18 
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Which of the following terms 


WY Programmer 
m Manager 

MH Operator 

ma Instructor 


HAnn 
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Does your installation subscribe to the SRL Revision Service? m Yes 1 No 


How did you use this publication? 


Mm As an introduction 
As a reference manual 
As a text (student) 
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